V t 


程序 源码 电子 课件 
44 个 知识 点 案例 5 个 完整 项 目 案例 


TERETI t: 


Spring Boot 
开发 实战 


CU DD 


zx pt O 编著 


TE EEA: 
dk m 


内 容 简介 
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本 书 内 容 通俗 易 懂 ， 适 合 Spring Boot 开发 的 初学 者 (特别 是 在 校 学 生 )、Web 应 用 开发 者 和 企业 级 应 
用 开发 爱好 者 等 学 习 ， 可 以 作为 高 等 学 校 的 教材 、 目 学 的 入 门 读物 、 开 发 过 程 的 参考 书 。 
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Spring 以 人 简化 企业 级 应 用 开发 为 己任 。 无 论 是 Web 应 用 开发 、 数 据 库 访 问 还 是 当前 的 
大 数据 处 理 、 分 布 式 应 用 集成 ， 都 能 看 到 Spring 的 身影 。 然 而 ， 一 转眼 ， 作 为 EJB 颠覆 者 
的 Spring 也 从 最 初 的 轻 量 级 工具 变 成 了 “庞然大物 ”。 而 Spring Boot 由 于 能 极 大 地 人 简化 配 
置 ， 并 且 能 和 当下 流行 的 微服 务 架 构 毛 合 ， 因 此 一 出 现 便 受 到 了 大 家 的 退兵 。 

Spring Boot 在 Java 应 用 开发 领域 快速 兴起 , 其 原因 除了 它 具 有 约定 大 于 配置 、 采 用 更 
简洁 的 配置 方式 来 替代 XML 等 特点 外 ， 还 有 一 个 重要 原因 是 用 Spring Boot 来 开发 时 不 需 
要 同时 面 对 多 个 框架 (如 Struts2、Spring 和 Spring MVC. Hinernate 或 MyBatis) 和 不 同 的 
视图 显示 技术 (如 JSP、Servlet 等 )。 

不 同 框架 之 间 的 联系 、 整 合 问 题 以 及 由 此 市 来 的 更 加 复杂 的 配置 问题 (特别 是 利用 
XML 进行 配置 时 ) 是 Spring 学 习 者 在 学 习 时 (特别 是 入 门 阶段 〉 需 要 和 面 对 的 一 个 重要 难 
题 。 而 Spring Boot 较 好 地 封装 了 相关 工具 和 框架 (如 Tomcat、Hibernate、MySQL IK 34, 
等 )， 可 以 开 箱 即 用 这 些 工 具 和 框架 ， 使 得 Spring Boot 开发 比较 简单 。 

但 是 ， 软 件 开发 领域 “没有 银 弹 ”。Spring Boot 全 面 封装 、 开 箱 即 用 使 得 开发 变 得 更 
加 快速 、 透 明 、 高 效 的 同时 ， 对 于 初学 者 而 言 ，Spring Boot 开发 时 的 依赖 管理 和 配置 信息 
设置 问题 是 需要 和 面 对 的 一 个 挑战 。 好 在 开发 工具 (如 Spring Tool Suite. IntelliJ IDEA) 以 
及 帮助 文档 可 以 有 效 地 帮助 Spring Boot 初学 者 降低 学 习 难 度 。 

另外 ，Spring Boot 的 应 用 比较 多 ， 这 使 得 Spring Boot 的 内 容 略 显 庞杂 。 而 且 ，Spring 
Boot 还 在 快速 地 更 新 ， 这 会 导致 本 书 介 绍 的 一 些 知识 点 在 新 版 本 中 可 能 会 有 更 新 ， 于 是 需 
要 读者 在 开发 时 参考 官方 文档 进行 知识 更 新 。 这 些 因素 也 增加 了 Spring Boot 的 学 习 难 度 。 

为 了 帮助 读者 更 好 地 掌握 Spring Boot 开发 技术 ， 本 书 按照 开发 步骤 组 织 各 章节 的 内 
F, 循序 渐进 地 介绍 Spring Boot 的 开发 知识 和 示例 代码 。 为 了 帮助 读者 更 好 地 安排 学 习 时 
间 和 帮助 教师 更 好 地 安排 授 读 ， 在 下 表 中 给 出 了 各 章 的 建议 学 时 《建议 学 时 分 为 建议 理论 
学 时 和 建议 实践 学 时 )。 

章 内 容 建议 理论 学 时 
第 1 章 Spring Boot 简介 
第 2 章 Spring Boot 开发 起 步 
第 3 章 Spring Boot 的 相关 注解 
第 4 章 Spring Boot 的 Web 应 用 开发 
第 5 章 Spring Boot 的 数据 库 访 问 
第 6 章 Spring Boot 的 Web 服务 开发 
第 7 章 Spring Boot 的 数据 处 理 
第 8 章 Spring Boot 的 文件 应 用 
第 9 章 Spring Boot 的 WebFlux 开发 
第 10 章 Spring Boot 开发 案例 
合计 学 时 
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在 开设 Spring Boot 开发 的 相关 恋 程 时 可 以 根据 总 学 时 、 学 生 基 础 和 教学 目标 等 情况 调 
整 各 章 的 学 时 。 学 习 者 也 可 以 有 选择 地 阅读 各 章节 内 容 并 安排 好 学 时 。 

为 便于 教学 ， 本 书 有 教学 视频 、 源 代码 、 课 件 等 配套 资源 。 

(1) 获取 教学 视频 方式 : GUB up ETATE OSCAR zd DI mU. Bi D PH 
NUF] ULL HERI, XUE BUE TU 

(20 获取 源 代码 及 参考 答案 方式 : Pci DAN OCRGEDIGRUS. PSifddü P7; — 
维 码 ， 即 可 获取 。 


源 代码 及 参考 答案 
G) 其 他 配 玛 资源 可 以 扫 插 本 书 封 抵 的 诛 件 二 维 公 下 载 。 
由 于 时 间 短 ， 加 上 编者 水 平 有 限 ， 书 中 难免 有 路 漏 之 处 ， 敬 请 谈 者 朋友 批评 指正 。 
编 者 
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1.1 Spring Boot 的 发 展 背景 


1.1.1 Spring 的 发 展 


作为 EJB WEE Sr, Spring 因为 轻 量 级 的 开发 方式 很 快 被 业界 接受 。Spring 的 发 展 使 
得 它 也 逐步 变 成 了 “庞然大物 ”。 历 史 有 怀 人 的 相似 ，Spring Boot 再 次 因 其 轻 量 级 的 开发 
方式 而 受到 大 家 的 退兵 。 

回顾 Spring 的 发 展 过 程 可 以 发 现 : Spring 1.X 时 代 是 通过 XML 文件 配置 Bean 并 实现 
Spring 与 其 他 框架 的 集成 。 随 看 项 目的 扩大 ， 配 置 XML 过 于 烦琐 ， 而 且 XML 文件 变 得 更 
加 爱 肿 不 堪 ， 难 以 理解 、 设 计 、 配 置 和 管理 。Spring 2.X 时 代 可 以 通过 Java 5 市 来 的 注解 
对 Bean 进行 声明 注入 。 从 Spring 3 开始 ，Spring 使 用 Java 配置 方式 来 管理 Bean, Jf X 
大 地 减少 了 XML MEH, ERESMA. 

Spring 框架 由 二 十 多 个 模块 组 成 ， 可 分 为 Test M), Core Container. CE ZERO. 
AOP (HMHE) Aspects (HJH), Instrumentation (监测 仪 )、Messaging CHO. 
Data Access/Integration 〈 数 据 访 问 /集成 )、Web 等 模块 ， 结 构 如 网 1-1 所 示 。 其 中 ， 核 心 容 
4s 1h Beans (模块 名 为 spring-beans). Core (模块 名 为 spring-core). Context. (模块 名 为 
spring-context) 和 SpEL (Spring Expression Language, Spring 表达 式 语 言 ， 模 块 名 为 
spring-expression) 等 模块 ， 数 据 访 问 /集成 模块 包括 JDBC (模块 名 为 spring-jdbc);, ORM 
(对 象 关系 映射 ， 模 块 名 为 spring-orm)、OXM (对 象 XML 映射 ， 模 块 名 为 Spring-oxm )、 
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JMS (Java 消息 服务 ， 模 块 名 为 spring-jms), Transactions (事务 ， 模 块 名 为 spring-tx) 等 
模块 ; Web 模块 包括 WebSocket (模块 名 为 spring-websocket ) Servlet (模块 名 为 
spring-webmvc), Web (模块 名 为 spring-web), Portlet (模块 名 为 spring-webmvc-portlet ) 
等 模块。 


Data Access/Integration 


JDBC ORM WebSocket Servlet 


Transactions 


AOP Aspects Instrumentation Messaging 
Core Container 
p! | | 


Test 


图 1-1 构成 Spring 框架 的 模块 图 


1.1.2 Spring 的 生态 圈 


Spring Boot 是 伴随 Spring 4 而 诞生 的 。 BR I Spring Boot 之 外 ，Spring 作为 企业 应 用 开 
发 的 轻 量 级 解决 方案 提供 了 许多 子 项 目 ， 了 解 这 些 子 项 目 可 以 更 好 地 理解 其 设计 架构 、 思 
想 并 使 用 Spimg. Spring 的 整个 生态 系统 包括 以 下 内 容 。 

Spring Framework(Core): Spring 的 核心 项 目 ， 其 中 包含 了 一 系列 IoC 容 需 的 设计 ， 提 
供 了 依赖 注入 的 实现 ; 同时 , 还 集成 了 AOP, 提供 了 面 加 切面 编程 的 实现 ; 当然 还 有 MVC, 
JDBC、 事 务 处 理 模块 的 实现 。 

Spring Boot: 提供 了 快速 构建 Spring 应 用 的 解决 方案 ， 达 到 “ 开 箱 即 用 ”， 使 用 默认 
的 Java 配置 来 实现 快速 开发 ， 并 “即时 运行 ”。 

Spring Batch: 提供 构建 批 处 理应 用 和 目 动 化 操作 的 框架 ， 专 门 用 于 离线 分 析 程 序 、 数 
据 批 处 理 等 场景 。 

Spring Data: 对 主流 的 关系 型 数据 库 提 供 文 持 ， 并 提供 使 用 非 关 系 型 数据 的 能 力 ， 如 
将 数据 存储 在 非 关 系数 据 库 或 MapReduce 中 的 分 布 式 存储 、 云 计算 存储 环境 等 。 

Spring Security; 通过 用 户 认 证 、 授 权 、 安 全 服务 等 工具 保护 应 用 ， 它 最 先 在 Spring 
性 区 中 的 名 字 是 Acegi HEAR. 

Spring Security OAuth: OAuth 是 一 个 第 三 方 的 模块 ， 提 供 了 一 个 开放 的 协议 的 实现 ， 
通过 这 个 协议 前 端 应 用 可 以 对 Web 应 用 进行 简单 而 标准 的 安全 调用 。 

Spring Web Flow: 基于 Spring MVC 提供 Web 应 用 开发 。 它 是 Web 工作 流 引 擎 ， 定义 
了 一 种 特定 的 语 吝 来 拉 述 工作 流 ; 同时 高 级 的 工作 泊 控 制 吉 引擎 可 以 管理 会 话 状态 。 
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Spring BlazeDS Integration: 提供 Spring 与 Adobe Flex 技术 集成 的 模块 。 

Spring Dynamic Modules: 提供 Spring 运行 在 OSGi 平台 上 面 癌 Java 的 动态 模型 系统 ， 
Eclipse 就 是 构建 在 OSGi 平台 上 的 。 

Spring Intergration: 通过 消息 机 制 为 企业 的 数据 集成 提供 了 解决 方案 。 

Spring AMQP: 高 级 消息 队列 协议 (Advanced Message Queuing Protocol)， 支 持 Java 
和 .NET AARE. AMQP 是 一 个 提供 统一 消息 服务 的 应 用 层 标准 局 级 消息 队列 协议 ， 是 
一 个 开放 标准 , 为 面向 消息 的 中 间 件 设计 , 如 Rabbit MQ 等 。SpringSoruce 旗下 的 Rabbit MQ 
就 是 一 个 开源 的 AMQP B JI As. Rabbit MQ 是 用 Erlang 语言 开发 的 。 

Spring NET: 为 .NET 提供 与 Spring 相关 的 技术 文 持 ， 如 IoC 容器 、AOP 等 。 

Spring for Android: 为 Android 终端 开发 应 用 提供 Spring 文 持 。 

Spring Mobile: 为 移动 终端 的 服务 器 应 用 开 友 提供 文 持 。 

Spring Social: Spring 框架 的 扩展 ， 提 供与 社交 网 SNS 服务 API (如 Facebook, 3rik 
微 博 和 Twitter 等 ) 的 集成 。 

Spring XD: 用 来 简化 大 数据 应 用 开发 。 

Spring Cloud: 为 分 布 式 系统 开发 提供 工具 集 。 

Spring HATEOAS: 基于 HATEOAS 原则 简化 REST 服务 开发 。HATEOAS 是 “ 超 文 本 
JkzJjj" (Hypermedia As The Engine Of Application State) 的 英文 缩写 ， 又 名 “将 超 媒 体 作 为 
应 用 状态 的 引擎 ”。 

Spring Web Services: 提供 了 基于 协议 有 限 的 SOAP/Web 服务 。SOAP 是 简单 对 和 象 访问 
协议 (Simple Object Access Protocol) 的 英文 缩写 。 

Spring LDAP: 简化 使 用 LDAP FE LDAP 是 轻 量 目录 访问 协议 (Lightweight Directory 
Access Protocol) 的 英文 缩写 。 

Spring Session: 提供 一 个 API 及 实现 来 管理 用 户 会 话 信息 。 


1.1[3 Spring Boot 的 发 展 


Spring Boot 是 伴随 Spring 4 而 诞生 的 ， 它 在 继承 Spring 优点 的 基础 上 ， 人 简化 了 基于 
Spring 的 开发 。Spring Boot 使 得 开发 者 可 以 更 容易 地 创建 基于 Spring 的 可 以 “即时 运行 ” 
的 应 用 和 服务 。 所 以 ， 一 经 推出 就 引起 业界 极 大 的 关注 。 

Spring Boot 是 由 Pivotal 团队 开发 的 ， 其 设计 目的 是 简化 创建 Spring 应 用 的 初始 搭建 
和 开发 过 程 。Spring Boot 使 用 特定 的 方式 进行 配置 ， 使 得 开发 人 员 不 绸 需要 定义 样板 化 的 
配置 。 通 过 这 种 方式 Spring Boot 成 为 了 快速 应 用 开发 (Rapid Application Development, 
RADO 领域 的 领导 者 。 

Spring Boot 并 不 提供 Spring 框架 的 扩展 功能 , 只 是 用 于 快速 地 开发 基于 Spring 的 应 用 
程序 。 它 并 不 是 Spring WEAH, MF Spring 紧密 结合 来 提 融 Spring 应 用 开 友 者 开发 
体验 的 工具 。 

2014 年 4 月 发 布 了 Spring Boot 1.0。 本 书 开始 编写 时 ，Spring Boot 最 新 版 本 为 2.0.2 
版 ;， 本 书 编写 完成 时 最 新 版 本 为 2.0.6 版 。 本 书 的 例子 主要 基于 Spring Boot 2.0.2 编写 ， 例 


< < 
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子 中 一 直 用 的 是 当时 最 新 版 本 ， 个 别 例 子 用 到 了 2.0.6 版 ， 但 是 这 些 版 本 的 不 同 不 会 影响 
到 本 书 的 使 用 。 


1.2 Spring Boot 的 特征 


1.2.1 Spring Boot 的 特点 


Spring Boot 使 得 创建 独立 (或 产品 级 ) 的 基于 Spring 应 用 变 得 更 容易 ， 大 多 数 Spring 
Boot 应 用 只 需要 很 少 的 Spring 配置 。 开 发 Spring Boot 的 主要 目的 是 为 所 有 Spring 开发 者 
提供 一 个 更 迅速 、 可 用 的 入 门 经 验 。Spring Boot 坚持 “ 开 箱 即 用 ”， 为 具有 许多 类 的 工程 
提供 一 系列 音 用 的 非 功 能 特性 〈 例 如 和 藤 入 式 服 务 器 、 安 人 全、 度量、 健康 检 租 、 外 部 配置 等 )。 

Spring Boot. 的 特点 如 下 。 

(1) 约定 大 于 配置 。 通 过 代码 结构 、 注 解 的 约定 和 命名 规范 等 方式 来 减少 配置 ， 并 采 
用 更 加 简洁 的 配置 方式 来 蔡 代 XML 配置 ， 减 少见 余 代 人 码 和 强制 的 XML 配置。 

(2) 能 创建 基于 Spring 框架 的 独立 应 用 程序 。 

(3) ARA Tomcat, RE War 文件 。 

(4) 4Y Maven 配置 ， 并 推荐 使 用 Gradle #4} Maven 进行 项 目 管 理 。Maven 用 于 项 
目的 构建 ， 主 要 可 以 对 依赖 包 进 行 管理 。Maven 将 项 目 所 使 用 的 依赖 包 信 息 放 到 pom.xml 
文件 的 <dependencies></dependencies> 结 点 之 间 。 

(5) 目 动 配置 Spring。 

(6) 提供 生产 束 绪 型 功能 。 提 供 了 一 些 大 型 项 目 中 第 见 的 非 功 能 特性 ， 如 奶 入 式 服 务 
髓 、 安 人 全、 指标、 健康 检测 、 外 部 配置 等 内 容 。 

(7) 定制 “ 开 箱 即 用 ”的 Starter， 没 有 代码 生成 ， 也 无 顷 XML 配置 ， 还 可 以 修改 默 

(8) 为 Spring 开发 者 提供 更 快 的 入 门 体验 。Spring Boot 不 是 对 Spring 进行 功能 上 的 增 
强 ， 而 是 提供 了 一 种 更 快速 的 Spring 使 用 方法 。 

(9) 对 主流 框架 无 配置 集成 ， 目 动 整 合 第 三 方 框架 ， 如 Struts. 

(10) 使 用 注解 使 编码 变 得 更 加 人 简单。 

(11) 与 基于 Spring Cloud 的 微服 务 开发 无 颖 结合。 


1.2.2 Spring Boot 2 的 新 特性 


相对 于 Spring Boot 1, Spring Boot 2 是 一 个 重要 的 更 新 版 本 ， 它 新 增 的 特性 有 以 下 三 
OAE 

CDD 对 Gradle 插件 进行 了 重 写 ， 以 便于 项 目 管 理 。 

(2) 基于 最 新 的 Java 8 和 Spring Framework 5. Java 8 中 引入 了 函数 式 编 程 ， 并 极 大 地 
改善 了 并 发 程序 开发 体验 ; Spring Framework 5 推出 了 新 的 啊 应 式 Web 框架 ， 这 使 得 基于 
Spring Boot 2 开发 企业 级 应 用 变 得 更 加 人 简单， 可 以 更 方便 地 构建 啊 应 式 编 程 模型 。 
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(3) 对 与 Spring Boot 相关 的 Spring Data、Spring Security、Spring Integration 等 内 容 进 
行 了 更 新 。 

由 于 本 书 所 用 到 的 版 本 是 2.0.2 及 以 后 版 本 ， 所 以 下 文 除 非 是 为 了 区 分 或 强调 ， 否 则 
Spring Boot 均 指 Spring Boot 2. 


1.2.3 Spring Boot 2 的 核心 模块 


Spring Boot 2 中 spring-boot 模块 是 Spring Boot 2 的 核心 工程 。 

spring-boot 模块 提供 了 一 些 特性 来 文 持 Spring Boot 的 其 他 模块 , 这些 特 性 包括 以 下 四 
个 方面 。 

(1) SpringApplication 类 提供 了 静态 方法 以 便于 写 一 个 独立 的 Spring 应 用 程序 ， 该 类 
的 主要 职责 是 创建 和 更 新 一 个 合适 的 Spring 应 用 程序 上 下 文 (ApplicationContext)。 

(2) 给 Web 应 用 提供 了 一 个 可 选 的 Web 容器 (如 Tomcat 或 Jetty 等 )。 

(3) 通过 application.properties 文件 等 方式 提供 一 流 的 外 部 配置 的 文 持 。 

(40 提供 了 便捷 的 应 用 程序 上 下 文 的 初始 化 器 ， 以 便 在 使 用 它 之 前 对 其 进行 用 户 定制 。 

Spring Boot 中 spring-boot-autoconfigure 模块 是 实现 目 动 配置 Cauto-configuration) 的 
核心 工程 。Spring Boot 可 以 依据 classpath 里 依赖 的 内 容 来 目 动 配置 Bean 到 IoC Rs, fH 
是 要 开局 这 个 目 动 配置 功能 需要 添加 @EnableAutoConfiguration 注解 。auto-configuration 会 
尝试 推 央 哪些 Bean 是 用 户 可 能 会 需要 的 。 例 如 ， 在 当前 classpath 下 有 HSQLDB 包 ， 并 且 
用 户 没有 配置 其 他 数据 库 链 接 ， 这 时 目 动 配置 功能 会 自动 注入 一 个 基于 内 存 的 数据 库 连 接 
到 应 用 的 IoC 容器 。 目 前 auto-configuration 提供 Web、 JDBC, Spring Data JPA, Spring Batch, 
Thymeleaf、Reactor 等 注解 。auto-configuration 使 用 在 class 上 标注 @Configuration 注解 实 
现 。 使 用 @Configuration 时 一 般 融 有 约束 ， 例 如 ， 同 时 在 类 上 标注 了 @ConditionalOnClass 
和 人 @ConditionalOnMissingBean， 这 样 auto-configuration 只 会 在 classpath 下 存在 类 并 且 需 要 
的 Bean 还 没有 被 注入 IoC 时 才 生 效 。 

Spring Boot 中 提供 了 许多 starter 模块 ， 为 开发 者 提供 了 许多 “一 站 式 ” 服 务 。 通 过 在 
项 目 添加 对 应 框架 的 starter 依赖 ， 可 以 免 去 到 处 寻找 依赖 包 的 贱 烦 。 只 要 加 一 个 依赖 项 目 
就 可 以 运行 ， 这 就 是 starter 的 作用 。Spring Boot 官方 提供 的 starter 模块 ， 一 般 命 名 规则 为 
"spring-boot-starter -* ”， 其 中 “* ”代表 要 使 用 的 应 用 。 

Spring Boot 的 starter 模块 包括 : 

(1) spring-boot-starter， 这 是 Spring Boot 的 核心 司 动 器 ， 包 含 了 目 动 配置 、 日 志 : 
YAML., 

(2) sprimng-boot-starter-actuator， 帮 助 监 控 和 管理 应 用 。 

(3) sprimg-boot-starter-amqp， 通 过 spring-rabbit 来 支持 AMQP (Advanced Message 
Queuing Protocol). 

(4) spring-boot-starter-aop， 文 持 和 而 同方 面 编 程 (AOP)， 包 括 spring-aop 和 AspectJ. 

(5) spring-boot-starter-artemis， 通 过 Apache Artemis 文 持 JMS 的 API (Java Message 
Service API). 

(6) spring-boot-starter-batch, X fy Spring Batch， 包 括 HSQLDB 数据 库 。 
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(7) spring-boot-starter-cache， 文 持 Spring 的 Cache 抽象 。 

(8) spring-boot-starter-cloud-connectors， 文 持 Spring Cloud Connectors， 人 简化 了 在 像 
Cloud Foundry 或 Heroku 这 样 的 云 平台 上 的 连接 服务 。 

(9) spring-boot-starter-data-elasticsearch， 文 持 ElasticSearch 搜索 和 分 析 引 擎 ， 包 括 
spring-data-elasticsearch. 

(10) spring-boot-starter-data-gemfire, xF} d GemFire 的 分 布 式 数据 存储 ， 包 括 
spring-data-gemfire。 

( 11) spring-boot-starter-data-jpa, 文 持 JPA (Java Persistence API), 包括 spring-data-jpa、 
spring-orm 和 Hibernate。 

(12) spring-boot-starter-data-mongodb， 支 持 MongoDB 数据 库 ， 底 层 使 用 MongoDB 
驱动 操作 MongoDB 数据 库 ， 包 括 spring-data-mongodb. 

(13) spring-boot-starter-data-rest， 通 过 spring-data-rest-webmvc， 文 持 通 过 REST 4% f 
Spring Data 数据 仓库 。 

(14) spring-boot-starter-data-solr， 文 持 Apache Solr 搜索 平台 ， 包 括 spring-data-solr。 

(15) spring-boot-starter-freemarker, xj FreeMarker 模板 引擎 。 

(16) spring-boot-starter-groovy-templates, x £j Groovy 模板 引擎 。 

(17) spring-boot-starter-hateoas， 通 过 spring-hateoas 文 持 基于 HATEOAS 的 RESTful 
Web 服务 。 

(18) spring-boot-starter-hometq， 通 过 HornetQ 文 持 JMS. 

(19) spring-boot-starter-integration， 文 持 通 用 的 spring-integration 模块 。 

(20) spring-boot-starter-jdbc， 文 持 用 JDBC 访问 数据 库 。 

(21) spring-boot-starter-jersey, xfj Jersey RESTful Web 服务 框架 。 

(22) spring-boot-starter-jta-atomikos, 3f Atomikos 支持 JTA 分 布 式 事务 处 理 。 

(23) spring-boot-starter-jta-bitronix， 通 过 Bitronix x: f£ JTA 分布 式 事 务 处 理 。 

(24) spring-boot-starter-mall， 文 持 javax.mail。 

(25) spring-boot-starter-moblle， 文 持 Spring-moblle。 

(26) spring-boot-starter-mustache, xj Mustache 模板 引擎 。 

(27) spring-boot-starter-redis， 文 持 键 值 存储 数据 库 Redis， 包 括 spring-redis. 

(28) spring-boot-starter-security, 3 fj spring-security - 

(29) spring-boot-starter-social-facebook, 3 fy spring-social-facebook. 

(30) spring-boot-starter-social-linkedin, 3 ff spring-social-linkedin. 

(31) spring-boot-starter-social-twitter, X 1j spring-social-twitter. 

(32) spring-boot-starter-test， 文 持 种 规 的 测试 依赖 ， 包 括 JUnit, Hamcerest, Mockito 
以 及 spring-test 模块 。 

(33) spring-boot-starter-thymeleaf， 文 持 Thymeleaf 模板 引擎 ， 包 括 与 Spring 的 集成 。 

(34) spring-boot-starter-velocity, x fF Velocity 模板 引擎。 

(35) spring-boot-starter-web, XEIRA Web 开发 ， 包 括 Tomcat 和 spring-webmvc. 

(36) spring-boot-starter-websocket, x {F WebSocket 开发 。 

(37) spring-boot-starter-ws, xfj Spring Web Services. 
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(38) spring-boot-starter-actuator， 增 加 了 面 问 产品 上 线 相 关 的 功能 ， 如 测量 和 监控 。 

(39) spring-boot-starter-remote-shell， 增 加 了 远程 ssh shell 的 文 持 。 

(40) spring-boot-starter-jetty， 引 入 了 Jetty HTTP 引擎 (可 用 于 替换 Tomcat). 

(41) spring-boot-starter-log4j, xfj Log4J 日 志 框 架 。 

(42) spring-boot-starter-logging， 引 入 了 Spring Boot 默认 的 日 志 框 架 Logback。 

(43) spring-boot-starter-tomcat， 引 入 了 Spring Boot 默认 的 HTTP 引擎 Tomcat. 

(44) spring-boot-starter-undertow, 4]|A Y Undertow HTTP 引擎 〈 可 用 于 蔡 换 Tomcat). 

Spring Boot 中 spring-boot-actuator 模块 提供 了 许多 附加 功能 ， 可 以 实现 在 应 用 程序 部 
署 到 生产 环境 后 对 应 用 程序 进行 监控 和 管理 。Spring Boot 提供 了 shell 等 方式 来 管理 和 监 
控 应 用 程序 。 另 外 ， 审 计 、 监 控 和 性 能 指标 的 收集 可 以 目 动 应 用 到 应 用 程序 上 。 

Spring Boot 中 spring-boot-cli 模块 文 持 命令 行 工具 Spring Boot CLI， 可 以 用 来 快速 搭 
建 一 个 Spring 原型 应 用 ， 并 且 可 以 运行 Groovy 脚本 。 

Spring Boot 中 spring-boot-loader 模块 允许 通过 使 用 Java -jar archive.jar m 493511 6.55 lk 
套 依 赖 的 Jar. War X fF, Spring Boot Loader 提供 了 三 类 启动 器 (Jar, War, Properties 
Launcher), 3x 4625 Jr 2] gi fib ^] FA 2K UC EE E Jar 里 面 的 资源 (如 class 文件 .配置 文件 等 )。 

Spring Boot 中 tools 模块 提供 了 Spring Boot 开发 者 的 常用 工具 集 。 如 
spring-boot-gradle-plugin, spring-boot-maven-plugin 就 在 这 个 模块 里 面 。 


1.3 Spring Boot 的 工作 机 制 


1.3.1 Spring Boot 应 用 局 动人 口 类 的 分 析 


以 一 个 最 简单 的 Spring Boot 应 用 为 例 ， 程 序 启动 的 入 口 类 代码 如 例 1-1 所 示 。 
【 例 1-1】 程序 启动 的 入 口 类 代码 示例 。 


@SpringBootApplication 
public class Example { 
@RequestMapping ("/") 
String home() ( 
return "Hello World'!"; 


} 
public static void main(String[] args) throws Exception { 


SpringApplication.run(Example.class, args); 


} 


分 析 代 人 码 可 以 发 现 ,注解 在 代码 中 占有 重要 的 位 置 。 其 中 ,注解 @SpringBootApplication 
用 于 局 动 Spring Boot; 注解 @SpringBootApplication FI @Configuration, (@EnableAuto- 
Configuration、@Component 等 三 个 注解 完全 等 价 〈 即 前 面 注解 是 由 后 面 三 个 注解 合并 而 
成 )。@RequestMapping 注解 用 于 进行 映射 天 系 的 设置 。 

由 于 注解 在 代码 中 占据 重要 的 位 置 ,理解 并 掌握 Spring Boot 注解 的 用 法 是 Spring Boot 


人 
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学 习 者 必须 要 迈 过 去 的 一 道 坎 。 正 是 由 于 这 个 原因 ， 本 书 在 第 3 章 专门 介绍 Spring Boot 
注解 相关 知识 。 


1.3.2. Spring Boot 2 的 幕后 工作 


以 一 个 Spring MVC 应 用 为 例 ， 应 用 的 步骤 一 般 包括 : 

CD 用 户 向 服务 器 发 送 请 求 ， 请 求 被 Spring 前 端 控 制 器 DispatcherServlet 捕获 ; 初始 
化 Spring MVC 的 DispatcherServlet。 

(2) 搭建 转 码 过 滤器 ， 保 证 客户 站 的 请 求 正确 转 人 码 。 

(30 视图 解析 。 

(4) 配置 静态 资源 (如 CSS 文件 )。 

(5) 配置 所 文 持 的 地 域 及 资源 包 (ResourceBundle)。 

(6) 配置 multipart 解析 占 ， 保 证 文件 上 传 正 常 工作 。 

(7) 局 动 内 藤 的 服务 器 (Tomcat 或 Jetty 55). 

(85 建立 错误 反馈 页 面 。 

Spring Boot 为 Web 开发 者 实现 了 Spring MVC 应 用 的 所 有 相关 事情 。 因 为 这 些 配 置 都 
与 应 用 相关 ,所 以 应 用 Spring Boot 开发 时 ,可 以 无 限制 地 组 合 这 些 配 置 。 一 定 程度 上 ,Spring 
Boot 是 市 有 一 定 倾 问 性 的 Spring MH MEg; 它 基于 约定 并 在 项 目 中 默认 章 循 这 些 约定 。 


1.3.3 SpringApplication 的 执行 流程 


SpringApplication 是 Spring Boot 局 动 的 完整 解决 方案 ， 在 没有 特殊 需求 的 情况 下 ， 
SpringApplication 提供 的 默认 执行 流程 吏 可 以 满足 Spring Boot 的 需要 了 。 一 般 来 讲 ， 
SpringApplication 的 执行 流程 为 : 

(1) SpringApplication 实例 化 和 初始 化 。 

(2) 执行 run(0 方 法 。 方 法 开始 执行 时 ， 首 先 志 历 执行 所 有 通过 SpringFactoriesLoader 
可 以 得 找到 并 加 载 的 SpringApplicationRunListener， 调 用 它们 的 started0O 方 法 ， 告 诉 这 些 
SpringApplicationRunListener 即将 开始 执行 Spring Boot 应 用 。 

(3) 配置 Spring Boot 要 用 到 的 环境 ， 并 在 配置 好 环境 后 通过 过 有 历 调 用 所 有 
SpringApplicationRunListener 的 environmentPrepared0 的 方法 ,通知 Spring Boot 应 用 要 用 的 
环境 已 经 准备 好 。 

(4) 局 动 并 打印 Banner. 

(5) 根据 用 户 是 否 明确 设置 了 applicationContextClass 类 型 以 及 初始 化 阶段 的 推断 结 
R, WEIN AI Spring Boot 应 用 创建 什么 类 型 的 应 用 上 下 文 环境 ， 并 在 配置 好 后 通过 通 
历 调 用 所 有 SpringApplicationRunListener 的 contextPrepared() 方 法 通知 Spring Boot 应 用 要 
用 的 上 下 文 环境 已 经 准备 好 了 。 将 之 前 获取 的 所 有 配置 以 及 其 他 形式 的 IoC 容器 配置 加 载 
到 已 经 准备 完毕 的 ApplicationContext. 387; YHH Pr £j. SpringApplicationRunListener 的 
contextLoaded() 方 法 。 调 用 ApplicationContext 的 refresh() 方 法 ， 完 成 IoC 容器 可 用 的 最 后 
一 道 工序 。 
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(6) 查看 是 否 有 CommandLineRunner， 如 果 有 则 遍历 它们 。 

(7) WIAT SpringApplicationRunListener 的 fnished0 方 法 完成 所 有 功能 。 如 果 整 个 
过 程 出 现 寞 第 ， 则 在 调用 所 有 SpringApplicationRunListener 的 finished(O) 方 法 的 同时 会 将 异 
党 信息 一 并 传 入 处 理 。 


1.3.4 Spring Boot 应 用 启动 时 控制 全 输出 信息 


以 Web 应 用 为 例 ，Spring Boot 应 用 局 动 时 控制 台 输 出 信息 一 般 包 括 : 
(1) 局 动 App。 

(2) 查找 active profile, 71759] i 7j default. 

(35 刷新 上 下 文 。 

(4) 初始 化 服务 器 (如 Tomcat)、 启 动 Tomcat 服务 ， 启 动 Servlet. 
(5) Spring WxH WebApplicationContext 初始 化 。 

(6) 映射 servlet 和 filter。 

(7) 查找 @ControllerAdvice。 

(8) 路 径 映 射 。 

(9) Tomcat 局 动 完毕 。 

(100 App 局 动 耗费 的 时 间 。 


2]zà 1 


简 答 题 

l. Ë Spring 的 生态 圈 。 

简 述 Spring Boot 的 特点 。 

简 述 Spring Boot 的 starter 模块 组 成 。 

简 述 SpringApplication 的 执行 流程 。 

以 Web 应 用 为 例 ， 简 述 Spring Boot 应 用 启动 时 控制 台 输 出 信息 的 组 成 。 


Nn Ae w N 
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本 章 主要 介绍 如 何 配置 Spring Boot 的 开发 环境 、 如 何 用 两 款 常 见 开发 工具 创建 项 目 、 
如 何 用 两 款 常 见 开发 工具 实现 Hello World 的 Web 应 用 、 以 Hello World 应 用 为 例 说 明 项 目 
属性 配置 、Spring Boot 开发 的 一 般 步 又 等 内 容 。 
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Pivotal 团队 设计 Spring Boot 的 目的 是 简化 Spring 应 用 的 搭建 和 开发 过 程 。Spring Boot 
使 用 特定 的 方式 进行 配置 ， 从 而 使 开发 人 员 不 册 需 要 定义 样板 化 的 配置 。 通 过 这 种 方式 ， 
Spring Boot 在 和 钾 劲 发 展 的 快速 应 用 开发 领域 成 为 领导 者 。Spring Boot 的 特点 包括 创建 独立 
的 Spring 应 用 程序 、 目 动 配置 Spring 等 。 

在 进行 Spring Boot 开发 之 前 , 先 要 配置 好 开发 环境 。 配置 开发 环境 , 需要 先 安装 JDK, 
MAH ETE CE A HS ET A LA. Cli Intelli IDEA). 


2..4 安装 JDK 


使 用 2.0.0 以 上 版 本 的 Spring Boot 需要 安装 1.8 及 以 上 版 本 的 JDK, 可 以 从 Java 的 官 
网 Chttp://www.oracle.com/technetwork/java/javase/downloads/ndex.html) 下 载 安装 包 。 安 装 
完成 后 ， 配 置 环境 JAVA HOME. 配置 好 JAVA HOME 后 , 将 %JAVA HOME%\bin 加 入 系 
统 的 环境 变量 path 中 。 完 成 配置 后 ， 打 开 Windows 命令 处 理 程 序 CMD， 输 入 命令 java 
-version， 如 果 见 到 如 图 2-1 所 示 的 版 本 信息 就 说 明 JDK 安装 成 功 了 。 
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Es 命令 提示 符 


ficrosoft rino s [ Ll 10. 0. 16299. 431] 
(c) 2017 Micro M Corporatione 保留 所 有 权利 。 


2..aQAuUdsersiws2]ava version 


java version "1.8.0 144^ 


Java(TM) SE Runtime Environment (build 1.8.0 144—501) | 
Java HotSpoti!TM) 64-Bit Server VM (build 25. 144-b01, mixed mode) 


图 2-1 JDK 安装 成 功 后 显示 的 版 本 信息 


2.1.2 ZU IntelliJ IDEA 


可 以 从 IntelliJ IDEA. CEA FEA IDEA) 的 官网 Chttpsz//www.jetbrains.com) FE fe 
费 的 社区 版 或 者 旗舰 试用 版 IDEA， 然 后 进行 安装 ， 安 装 完成 后 打开 IDEA, " 显示 如 
图 2-2 所 示 的 欢迎 界面 。 由 于 IDEA 目 市 有 Maven 和 Gradle 插件 ， 所 以 不 用 再 安装 Maven 
和 Gradle 插件 。 


Welcome to Intelli) IDEA 


springboot-xf 
DAbcIDEAXspringboot-xf 


mybatis-demo 

mybatis-springboot 

ve intelli.) IDEA 
. Version 2018.1.2 

springboothello1 


X* Create New Project 


spring-boot-hello1 


Y Import Project 
02-springboot-web 
FA Open 


03-springboot-mybatis $ Check out from Version Control ~ 
spring-boot-ui 


masterSpringMvc 


Xt Configure ~ Get Help ~ 


springboothello3 


图 2-2 IDEA 局 动 后 的 欢迎 界面 


2.1.3 ”安装 Spring Tool Suite 


Spring Tool Suite (L F JEK STS)〉 是 被 包装 过 的 Eclipse， 主 要 用 于 快速 地 开发 Spring 
项 目 。 利 用 STS 开发 者 不 峙 需要 编辑 烦琐 的 XML 配置 文件 ， 而 是 由 工具 目 动 生成 。STS 
AARIIN: PEE Eclipse 223€ STS 插件 ; 另 一 种 是 从 官网 (https:/spring.lo/tools/ 
sts/all ) 上 直接 下 载 、 安 装 STS。 还 可 以 从 官网 上 直接 下 载 解 压缩 后 即 可 使 用 的 STS. STS 
局 动 后 的 界面 如 向 2.3 DIEN 


11 


12; — Spring Boot 开发 实战 一 一 微 课 视频 版 


C^. workspace-sts-3.9.0.RELEASE - Spring Tool Suite 
Hle Edit Source Refactor Navigate Search Project Run Window Help 


n- BRO- Oxi OEG HH- O- - T5 -i6 E G -: 
H Package Explorer 25 B B, | s "7 S DH | Ø Dashboard X% 


> 3 demo [boot] 


> LZ Servers A - 
> 证 3 > spring-boot-db [spring-boot-db master] e Spring 


$ Tooling Updates 


STS 3.9.4 has been released 
News 

Spring Tips: Apache Camel 
speaker: Josh Long (@starbuxman) Hi Sp 
Camel enterprise integration framework, its 
observability, iis _ Josh Long 2018-5-23 
This Week in Spring - May 22nd, 
Hi Spring fans! Whew! What a wild week it's 
present at the epic JEEConf in beautiful Kie: 
and Belfast ... Josh Long 2018-5-23 

Enjoy quality time with the Spring a 


Platform 


Hey there. It feels like SpringOne Platform 
coming in September! IUs yet another excu: 
enjoy quality time .. Stephane Maldini 2018 


图 2-3 STS 启动 后 的 界面 


由 于 STS 只 是 目 市 有 Maven 插件 ,所 以 需要 使 用 Gradle 进行 开发 时 ,需要 再 安装 Gradle 
插件 。 安 装 Gradle 插件 的 步骤 包括 : 首先 选择 亲 单 栏 Help 项 中 Eclipse Marketplace 子 项 后 
进入 Marketplace Wi; 然后 在 Find 文本 框 中 输入 Gradle 进行 搜索 ; 最 后 单 击 Install 按钮 
就 可 以 成 功 安 装 Gradle 插件 。STS 中 安装 Gradle 插件 的 界面 如 几 2-4 所 示 。 


(€ Eclipse Marketplace 口 X 


Eclipse Marketplace 
elect solutions to install. Press Install Now to proceed with installation. 


Press the "more info" link to learn more about a solution. 


Search Recent Popular Favorites Installed " Eclipse Newsletter: Boot *|* | 


Find: ‘Gradle| QL | | Ali Markets v All Categories yel 


| m | |"* | HISUOHS. J LI,U TE OD TIPOTRUTJ 


Gradle IDE Pack 3.8.x- 1.0.x 4 2.2.x 


-— Install Pivotal Gradle IDE & Enide Gradle for Eclipse & EGradle 
Editor in one operation. This plugin set works in any Eclipse 
e (from Neon downto 3.7.2). For.. more info 

by Nodeclipse/Enide, EPL 

gradle IDE editor run build ... 


* 62 Ed Installs: 261K (4,008 last month) Install 


Enide Studio 2014 - Node.js, JavaScript, Java and 
Web Tools 1.0.1 


Nodeclipse "Enide Studio 2014" is Tool Suite for Node ;js, 
^ JavaScript, Java Development. This is the most feature-rich 


pack. Unless there is the latest version... more info 


Marketplaces 


DE 


图 2-4 STS 中 安装 Gradle 插件 的 界面 
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22 创建 项 目 


可 以 用 不 同 的 工具 创建 Spring Boot 项 目 ， 每 种 工具 也 可 以 采用 不 同 的 $ 
创建 项 目 方法 。 本 节 介绍 两 种 常见 开发 工具 创建 项 目的 方法 。 视频 讲解 


2.2.1 利用 IDEA 创建 项 目 


先 在 如 图 2-2 所 示 的 欢迎 界面 中 选择 Create New Projcet 链接 进入 项 目 创 建 界 面 ， 并 选 
择 Spring Initializr 类 型 的 项 目 ， 如 图 2-5 所 示 。 


| Project SDK: — &1.8 (java version "1.8.0 144") 
Choose Initializr Service URL. 

@ Default: https;//start.spring.io 
C) Custom: | 


Make sure your network connection is active before continuing. 


© Application Forge 
SE Scala 


K Kotlin 


® Static Web 
DE Flash 


局 Empty Project 


图 2-5 IDEA 中 创建 新 项 目 时 选择 Spring Initializr 类 型 项 目的 界面 


Be, Hah Next 按钮 跳 转 到 项 目 信 息 的 配置 界面 ，IDEA 创建 新 项 目 时 要 根据 项 目 情 
况 设 置 项 目的 元 数据 (Project Matedata)， 设 置 项 目 元 数据 的 界面 如 图 2-6 所 示 。 

如 图 2-6 所 示 ， 在 所 创建 项 目 Group 文本 框 中 输入 com.bookcode， 在 Artifact 文本 框 
中 输入 springboot-helloworlds， 在 所 创建 项 目的 管理 工具 类 型 Type 中 选择 Maven Project。 
由 于 目前 Maven 的 参考 资料 比 Gradle 的 参考 资料 多 且 更 容易 获得 ， 本 书 示例 使 用 Maven 
进行 项 目 管 理 。 开 发 语言 Language 选择 Java; 打包 方式 Packaging 选择 Jar; 开发 工具 Java 
的 版 本 Java Version 选择 8〈 也 称 为 1.8); 所 创建 项 目的 版 本 Version. 保留 目 动 生成 的 
0.0.1-SNAPSHOT; 项 目 名 称 Name 保留 目 动 生成 的 springboot-helloworlds; 项 目 摘 述 
Description 可 以 修改 为 Book Code for Spring Boot; 所 创建 项 目 默认 的 包 名 Package 可 以 修 
改 为 com.bookcode。 
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g New Project 


Project Metadata 


Group: 


Artifact: 


Type: 
Language: 


" Packaging: 


com. bookrcode 


spnngboct-helloworlds 


Maven Project (Generate a Maven based project archive) v 


java v 


Java Version: 


Version: 
Name 
Descripton: 


Package: 


0.0.1-SNAPSHOT 


springboct-helloworlds 


Book Code for Spring Boot 


[com. bookcode | 


Previous Cancel Help 


图 2-6 IDEA 创建 新 项 目 时 设置 项 目 元 数据 (Project Metadata) 的 界面 


填写 完 项 目的 元 数据 后 ， 单 击 Next 按钮 就 可 以 进入 选择 项 目 依赖 (Dependencies) 的 
界面 。 如 图 2-7 所 示 ，IDEA 自动 选择 了 Spring Boot 的 最 新 版 本 (本 例 中 2.0.2 版 )， 也 可 
以 手动 选择 所 需要 的 版 本 ， 再 手动 为 所 创建 的 项 目 Cspringboot-helloworlds) 选择 Web 依 
M. 选择 完 Web 依赖 , IDEA 就 可 以 帮助 开发 者 完成 Web 项 目的 初始 化 工作 。 创建 项 目 时 ， 


也 可 以 不 选择 任何 依赖 ， 而 在 文件 pom.xml 中 添加 所 需要 的 依赖 。 


Bl New Project 


Dependencies |C. 


II 
CO Reactive Web Web 


Template Engines 
SOL 

NoSQL 

Integration 

Cloud Core 

Cloud Config 

Cloud Discovery 
Cloud Routing 

Cloud Circuit Breaker 
Cloud Tracing 


Cloud Contract 
Pivotal Cloud Foundry 
Azure 

Spring Cloud GCP 
Jo 

Ops 


Spring Boct| 2.0.2 v 


Selected Dependencies 


C Rest Repositories 

L ]Rest Repositories HAL Browser 
[ ]HATEOAS 

C] Web Services 

O Jersey (JAX-RS) 

[ ]Websocket 

L]REST Does 

[I] Vaadin 

Apache CXF (JAX-RS) 
Ratpack 

Mobile 

Keycloak 


Web 


Full-stack web development with Tomcat and Spring 
MVC 


$3 Building a RESTful Web Service 
$$ Serving Web Content with Spring MVC 
$3 Building REST services with Spring 


cp Reference doc 


Help 


Previous Cancel 


IDEA 创建 新 项 目 时 选择 依赖 (Dependencies) 的 界面 
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单 击 Next 按钮 后 ， 进 入 项 目 名 称 (Project Name) 和 项 目 位 置 (Project Location) 的 
显示 页 面 ， 可 以 直接 保留 由 图 2-6 生成 的 项 目 名 称 、 位 置 默认 值 ; 也 可 以 根据 需要 直接 修 
改 项 目 名 称 和 项 目 位 置 。 然 后 单 击 Finish 按钮 ， 就 可 以 进入 项 目 界面 。 由 于 所 创建 的 项 目 
管理 类 型 为 Maven Project， 所 以 项 目 中 pom.xml 文件 是 一 个 关键 文件 ， 其 代码 如 例 2-1 所 — 4 
示 。 例 2-1 代码 中 加 粗 部 分 代码 和 在 图 2-6 和 图 2-7 中 输入 、 选 择 的 项 目 元 等 数据 对 应 ， 
其 他 代码 是 IDEA 目 动 生成 的 辅助 内 容 。 其 中 ,<parent> 和 </paren 芒 之 间 的 内 容 表 示 父 依赖 ， 
是 一 般 项 目 都 要 用 到 的 基础 内 容 ， 包 含 了 项 目 中 用 到 的 Spring Boot 的 版 本 信息 。 
<properties> 和 </properties> 之 间 的 内 容 表 示 了 项 目 中 所 用 到 的 Java 版 本 信息 和 编码 格式 。 
<dependencies> 和 </dependencies> 之 则 的 信息 是 Maven 的 重点 内 容 ， 包 含 了 项 目 中 所 用 到 
的 依赖 信息 ， 其 中 <artifactId>spring-boot-starter-test</artifactId> 表 示 要 用 到 测试 依赖 ， 测 试 
依赖 在 创建 项 目 时 目 动 增加 , 无须 再 手动 添加 ; <artifactId>spring-boot-starter-web</artifactId> 
表示 要 用 到 Web 依赖 。<build> 和 </build> 之 间 的 内 容 表 示 编 译 运行 时 要 用 到 的 相关 插件 。 
XT Maven 依赖 的 更 多 情况 ， 将 在 后 和 面 的 例子 中 逐步 加 以 介绍 。 在 例 2-1 的 基础 上 ， 就 可 
以 进行 基于 Spring Boot 的 Web 项 目 开 发 了 。 

【 例 2-1】 pom.xml 文件 代码 示例 。 


E 


<?xml version-"1.0" encoding-"UTF-8"?» 
«project xmlns-"http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"» 

«modelVersion»4.0.0«/modelVersion» 

XgroupId»com.bookcode«/groupId» 

«artifactId»springboot-helloworlds«/artifactId» 

«version»0.0.1-SNAPSHOT«/version» 

«packaging»jar«/packaging» 

«name»springboot-helloworlds«/name» 

«description»Book Code for Spring Boot«/description» 

«parent» 

«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-parent«/artifactId» 
«version»2.0.2.RELEASE«/version» 

«relativePath/» «!-- lookup parent from repository --» 

«/parent» 

«properties» 
«project.build.sourceEncoding»UTF-8«/project.build.sourceEncoding» 
«project.reporting.outputEncoding»UTF-8«/project.reporting. 
outputEncoding» 
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<java.version>1 .8</java.version> 
<!-- 上 面 加 粗 内 容 和 图 2-6 中 设置 的 项 目 元 数据 对 应 --> 
«/properties» 
«dependencies» 

<!-- 下 面 加 粗 内 容 和 图 2-7 中 选择 的 web 依赖 对 应 --> 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-web«/artifactlId» 

«/dependency» 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-test«/artifactId» 
«scope»test«/scope» 

«/dependency» 

«/dependencies» 
«build» 

«plugins» 

«plugin» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-maven-plugin«/artifactId» 

«/plugin» 

«/plugins» 

«/build» 
«/project» 


全 此 ， 完 成 项 目的 创建 工作 。 在 此 基础 上 融 可 以 进行 Spring Boot 的 Web 项 目 开 发 了 。 
为 了 内 容 的 简洁 ， 在 本 书 以 后 章节 的 示例 和 案例 中 将 不 再 介绍 项 目的 创建 过 程 。 假 如 不 太 
清楚 Spring Boot 项 目 创建 过 程 ， 请 先 见 悉 本 节 内 容 ， 或 者 直接 参考 源 代码 中 每 个 项 目 中 
pom.xml 文件 的 内 容 。 


2.2.2 ”利用 STS 创建 项 目 


局 动 STS, XE Ul New 中 Spring Starter Project 子 项 后 可 以 进入 到 项 目 元 数据 设 
置 界面 。STS 设置 项 目 元 数据 的 方法 与 IDEA 相似 ， 如 图 2-8 所 示 。 单 击 Next 按钮 进入 到 
选择 项 目 依赖 的 界面 ， 如 图 2-9 所 示 。 选 择 Web 依赖 ， 默 认 情 况 下 STS 也 会 目 动 选择 当时 
最 新 版 Spring Boot。 单 击 Finsh 按钮 ， 进 入 到 项 目 界面 。 项 目 中 pom.xml 文件 的 代码 与 
例 2-1 的 代码 完全 相同 。 在 此 基础 上 ， 就 可 以 利用 STS 进行 基于 Spring Boot 的 Web 项 目 
开发 了 。 
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z 


New Spring Starter Project New Spring Starter Project Dependencies 


A 
Service URL http://start.spring.io Spring Boot Version: 2.0.2 v 


Name springboot-helloworlds Frequently Used: 


[7] Use default location C Thymeleaf [7| Web 


Locetion DAworkspace-sts-39.0.RELEASEVspringboot-helloworlds | 国友 
ocetior Workspace Mpringboot-hellowor | panem 


Type: Maven v Packaging: Type to search dependencies 
Java Version: Language: 
b Azure 


Group com.bookcode b Cloud AWS 


Artifact springboot-helloworlds b Cloud Circuit Breaker 
0.0.1-SNAPSHOT » Cloud Config 


b Cloud Contract 
Book Code for Spring Boot 

b Cloud Core 
T RR 


b Cloud Messaging 
[ Add project to working sets - b Cloud Routing 


Working sets: | ? Cloud Tracing 


b Core 
» Jo 
b Integration 


b NoSOL | Make Defaut | | Clear Selection 


v 
.  BNLMI a 


图 2-8 STS 创建 新 项 目 时 设置 元 数据 的 界面 


2.3 ”实现 Hello World 的 Web 应 用 


与 创建 项 目 一 样 , 也 可 以 用 不 同 的 工具 来 开发 、 实 现 Spring Boot 项 目 。 
本 节 介 绍 如何 利 用 IDEA, STS 两 种 工具 实现 Hello World 的 Web 应 用 。 视频 讲解 


2.3.1 用 IDEA 实现 Hello World 的 Web 应 用 


IDEA 创建 完 项 目 之 后 ， 项 目 中 目录 和 文件 的 构成 情况 如 图 2-10 所 示 。Spring Boot 项 
目 中 的 目录 、 文 件 可 以 分 为 三 大 部 分 。 其 中 ，src/main/java 目录 下 包括 主 程序 入 口 类 
SpringbootHelloworldsApplication， 可 以 运行 该 类 来 局 动 程序 ; 开发 时 需要 在 此 目录 下 添加 
所 需 的 接口 、 类 等 文件 。src/main/resources 是 资源 目录 ， 该 目录 用 来 存放 应 用 的 一 些 配 置 
信息 ， 如 配置 服务 器 站 口 、 数 据 源 的 配置 文件 application.properties。 由 于 开发 的 是 Web M 
用 ， 因 此 在 src/main/resources 下 产生 了 static 子 目 录 与 ttmplates 子 日 录 ，static 子 目 录 主 要 
用 于 存放 静态 资源 ， 如 图 片 、CSS、JavaScript fF; templates 子 目 录 主 要 用 于 存放 Web 
页 面 动 态 视 图 文件 。srcltesUjava 是 单元 测试 目录 ， 目 动 生 成 的 测试 文件 
SpringbootHelloworldsApplicationTests 位 于 该 目录 下 ， 用 该 测试 文件 可 以 测试 Spring Boot 
应 用 。 男 外 ，pom.xml 文件 是 项 目 管理 《特别 是 管理 项 目 依 赖 ) 的 重要 文件 。 

在 自动 生成 的 目录 和 文件 的 基础 上 ， 在 com.bookcode 包 下 新 建 controller 子 包 ， 然 后 
在 controller 子 包 中 创建 类 HelloWorldController， 人 代码 如 例 2-2 所 示 。 
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E Project v 
v fs springboot-helloworlds DASCloudProjectsVspringboot-helloworlds 
> Bidea 
> MM ,mvn 
$ v Msrc 


4 v D main 


w java 
v Bcom.bookcode 
R SpringbootHelloworldsApplication 


v resources 


P3 static 

Fx templates 

fg application.properties 
v Mtest 

v java 
v D com.bookcode 
€ SpringbootHelloworldsApplicationTests 

B .gitignore 
B mvnw 


8 mvnw.cmd 


* 2: Favorites 


M pom.xml 

fh springboot-helloworlds.iml 
> llll External Libraries 
》 Scratches and Consoles 


© web 


图 2-10 IDEA 创建 项 目 后 项 目的 目录 和 文件 构成 情况 


【 例 2-2】 控制 器 类 HelloWorldController 代码 示例 。 


package com.bookcode.controller; 
import org.springframework.web.bind.annotation.RequestMapping; 


import org.springframework.web.bind.annotation.RestController; 


QRestController // 返 回 的 默认 结果 为 字符 串 
public class HelloWorldController ( 
QGRequestMapping ("/hello") // 映 射 信息 ， 往 往 是 URL 的 组 成 部 分 


public String hello()( 


return "Hello World!"; 


} 


接着 运行 入 口 类 SpringbootHelloworldsApplication， 成 功 启 动 自 带 的 内 置 Tomcat。 在 
浏览 器 中 输入 localhost:8080/hello 后 ， 浏 览 器 中 的 显示 Web 应 用 运行 结果 如 图 2-11 所 示 。 


全 | localhost:8080/hello — x ^ 


€ Q | localhost:8080/hello 


Hello World! 


图 2-11 IDEA 实现 Hello World 的 Web 应 用 运行 结果 
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2.3.2 用 STS 实现 Hello World 的 Web 应 用 


STS 创建 完 项 目 之 后 ,项 目的 目录 和 文件 结构 如 图 2-12 所 示 ， 和 IDEA. 实现 的 项 目 情 
况 基本 相同 。 在 自动 生成 文件 的 基础 上 ， 在 com.bookcode 包 下 新 建 controller 子 包 ， 然 后 
在 controller 子 包 中 创建 一 个 HelloWorldController 类 ， 代 个 如 例 2-2 所 示 。 

接 看 运行 程序 ， 成 功 启 动 内 置 Tomcat， 上 再 在 浏览 器 中 输入 localhost:8080/hello， 浏 览 


器 中 的 结果 如 图 2-11 所 示 。 


I$ Package Explorer 23 


^ L3 Servers 
v i3 springboot-helloworlds [boot] 
v Æ src/main/java 
> 8j com.bookcode 
> 8B com.bookcode.controller 
v © src/main/resources 
& static 
E> templates 
£9? application.properties 
v @ src/test/Java 
> 8j com.bookcode 
> BÀ JRE System Library [JavaSE-1.8] 
> mà Maven Dependencies 
^ src 
& target 
[S mvnw 
mvnw.cmd 
m) pom.xml 


图 2-12 STS 创建 项 目 后 项 目的 目录 和 文件 构成 情况 


由 于 用 STS 和 IDEA 开发 Spring Boot 的 方法 类 似 , 考虑 a 到 IDEA 的 功能 更 丰富, 本 书 
选用 IDEA 作为 开 友 工具 。 


2.4 V Hello World 应 用 为 例 说 明 项 目 属 性 配置 


在 实现 Hello World 应 用 的 基础 上 , 可 以 基于 项 目 属性 配置 实现 对 Hello 视频 讲解 
World 应 用 的 扩展 。 在 Spring Boot 中 主要 通过 application.properties 文件 、 
application.yml 文件 实现 对 属性 的 配置 。 这 两 种 文件 的 格式 不 同 ， 但 内 容 对 应 、 作 用 相同 。 
配置 文件 的 默认 执行 顺序 依次 是 : 项 目 根 目录 下 config 子 目 录 、 项 目 根 目录 、 项目 classpath 
T H3& FII] config FHK, WH classpath FHK- 


2.4.1 ”配置 项 目 内 置 属性 


可 以 修改 application.properties 文件 ， 配 置 项 目 内 置 属性 ， 代 人 码 如 例 2-3 所 示 。 
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【 例 2-3】 配置 项 目 端口 、 路 径 等 内 置 属性 的 代码 示 例 。 
# 配 置 项 目 内置 属 性 ， 修 改 端口 


server.port-8888 


server.servlet.context-path-/website 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8888/website/hello, 4 n 2-13 所 示 。 对 比 
例 2-2、 例 2-3 中 代码 和 图 2-11、 几 2-13 中 URL， 可 以 发 现 例 2-3 通过 配置 文件 修改 了 服 
A iR BA VAT] Xi O FERIE e 


/ [1 localhost:8888/website x NY 


€ > Q |O localhost:8888/website/hello 


Hello World! 


图 2-13 ”修改 Web 应 用 Hello World If] Ht 25-23 5 iA im L1 Pf £6 o Ei Jn I0] R 


2.4.2 EpE Xm EUH 


可 以 修改 application.properties 文件 来 目 定 义 项目 属 性 ， 代 人 码 如 例 2-4 Pros 
【 例 2-4】 自 定 义 项 目 属性 的 代码 示例 。 
# 上 自 定 义 属性 


server.port-8888 
server.servlet.context-path-/website 
helloWorld-Hello SpringBoot! 
mysql.jdbcName-com.mysql.jdbc.Driver 
mysql.dbUrl-jdbc:mysql://localhost:3306/mytest 
mysql.userName-root 

mysql.password-sa 


再 修改 类 HelloWorldController， 代 码 如 例 2-5 所 示 。 
[52-5] 类 HelloWorldController 的 代码 示例 。 


package com.bookcode.controller; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 
import org.springframework.beans.factory.annotation.Value; 


QRestController // 返 回 的 默认 结果 为 字符 串 
public class HelloWorldController { 
QValue ("$[(helloWorld)") // 注 入 属性 值 


private String hello; 
QValue ("$(mysql.jdbcName]") 

private String jdbcName; 
QValue("S$(mysql.dbUrl)") 

private String dbUrl; 
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QValue("$(mysql.userNamej]") 
private String userName; 
QValue("$(mysql.passwordj") 
private String password; 
QGRequestMapping ("/hello") // 映 射 信息 ， 往 往 是 URL 的 组 成 部 分 
public String hello()( 
return hello; 


— < 


} 
@RequestMapping ("/showJdbc") // 映 射 信息 ， 往 往 是 URL 的 组 成 部 分 
public String showddbce() 
return "mysql.jdbcName:"-4jdbcName-"«br/»" 
T"mysqgli.dbUür!-"rdbürl1i"«br/»" 
-"mysql.userName:"-userName-"«br/»" 
-"mysql.password:"-«password-*"«br/»"; 


} 


接着 运行 程序 ， 在 浏览 器 中 输入 localhost8888/website/hello, £5 "nl 2-14 所 示 。 在 
浏览 器 中 输入 localhost:8888/website/showJdbc， 结 果 如 图 2-15 所 示 。 


/ [A localhost:8888/website X V 


€ Es | © localhost:8888/website/hello 


Hello SpringBoot! 


图 2-14 IDEA 中 日 定义 属性 后 在 浏览 器 中 输入 localhost:8888/website/hello 的 结果 


/ [A localhost:8888/website X IV Y 


€ C | © localhost:8888/website/showJdbc 


mysql.jdbcName:com.mysgql.jdbc.Driver 


mysgql.dbUrl:jdbc:mysq[://localhost:3306/mytest 
mysgl.userName:root 
mysql.password:sa 


图 2-15 IDEA 中 日 定义 属性 后 在 浏览 器 中 输入 localhost:8888/website/showJdbe 的 结果 


2.4.3 利用 自 定 义 配置 类 进行 属性 设置 


当 要 配置 的 自 定 义 属 性 比较 多 时 〈 如 例 2-4)， 可 以 考虑 和 目 定义 一 个 配置 类 。 目 定义 配 
置 类 MysqlProperties HRE i] 2-6 所 示 。 

[512-6] 目 定义 配置 类 MysglProperties 的 代码 示例 。 

// 上 日 定义 配置 类 


package com.bookcode.properties; 
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import org.springframework.boot.context.properties.ConfigurationProperties; 
import org.springframework.stereotype.Component; 
QGComponent // 构 件 
QGConfigurationProperties (prefix-"mysql") // 配 置 属 性 类 
public class MysqlProperties { 
private String jdbcName; 
private String dbUrl; 
private String userName; 
private String password; 
public String getJdbcName() ( 
return jdbcName; 
} 
public void setJdbcName (String jdbcName) ( 
this.jdbcName - jdbcName; 
} 
public String getDbUrl() { 
return dbUrl; 
} 
public void setDbUrl(String dbUrl) ( 
this.dbUrl = dbUrl; 
} 
public String getUserName() { 
return userName; 
} 
public void setUserName (String userName) ( 
this.userName - userName; 
} 
public String getPassword() { 
return password; 
} 
public void setPassword(String password) { 


this.password - password; 


然后 修改 类 HelloWorldController, RE tnt 2-7 所 示 。 
【 例 2-7】 类 HelloWorldController 的 代码 示例 。 


package com.bookcode.controller; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 
import com.bookcode.properties.MysqlProperties; 

import org.springframework.beans.factory.annotation.Value; 


import javax.annotation.Resource; 
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QGRestController // 返 回 的 默认 结果 为 字符 串 
public class HelloWorldController { 
QValue ("$(helloWorld])") // 注 入 属性 值 
private String hello; 
@Resource // 属 性 值 
private MysqlProperties mysqlProperties; 
QGRequestMapping ("/hello") // 映 射 信息 ， 往 往 是 URL 的 组 成 部 分 


public String hello()( 
return hello; 
} 
QGRequestMapping ("/showJdbc") / /映射 信息 ， 往 往 是 URL 的 组 成 部 分 
public String showJdbc () { 
mysqlProperties.setJdbcName ("com.mysql.jdbc.Driver"); 
mysqlProperties.setDbUrl ("jdbc:mysq1://1localhost:3306/mytest"); 
mysqlProperties.setUserName ("root"); 
mysqlProperties.setPassword("sa"); 
return "mysql.jdbcName:"«mysqlProperties.getJdbcName()-"«br/»" 
-"mysql.dbUrl:"«mysqlProperties.getDbUrl ()-*"«br/»" 
-"mysql.userName:"«mysqlProperties.getUserName()-"«br/»" 


-"mysql.password:"4«mysqlProperties.getPassword()-*"«br/»"; 


删除 配置 文件 中 相关 信息 ， 代 码 如 例 2-8 所 示 (请 对 照例 2-4 的 代码 )。 
[5]2-8] HENE HRERL. 


# 上 自 定 义 属 性 


server.port-8888 
server.servlet.context-path-/website 
helloWorld-Hello SpringBoot! 


运行 程序 后 在 浏览 器 中 输入 localhost:8888/website/hello, £55 nk 2-14 所 示 。 在 浏览 
器 中 输入 localhost:8888/website/showJdbc, £5 4n 2-15 所 示 。 


2.5 Spring Boot 开发 的 一 般 步骤 


2.5.14 软件 生命 周期 视频 讲解 


为 了 应 对 软件 危机 ， 产 生 了 软件 工程 学 。 软 件 工程 是 指导 计算 机 软件 开发 和 维护 的 一 
门 工程 学 科 。 采 用 工程 的 概念 、 原 理 、 技 术 和 方法 来 开发 与 维护 软件 ， 把 经 过 时 间 考 验 的 
管理 技术 和 当前 最 适用 的 技术 方法 结合 起 来 ， 以 经 济 地 开发 出 高 质量 的 软件 并 有 效 地 维护 
它 ， 这 融 是 软件 工程 。 
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按照 软件 工程 的 理论 ， 软 件 生 命 周 期 由 软件 定义 、 软 件 开 发 和 运行 维护 〈 也 称 为 软件 
维护 ) 3 个 时 期 组 成 ， 每 个 时 期 又 进一步 划分 成 奋 干 阶段 。 

软件 定义 时 期 的 任务 是 : 确定 软件 开发 工程 必须 完成 的 总 目标 ; 确定 工程 的 可 行 性 ; 
导出 实现 工程 目标 应 该 采用 的 策略 及 系统 必须 完成 的 功能 ;估计 完成 该 项 工程 需要 的 资 
源 和 成 本 ， 并 且 制 订 工 程 进度 表 。 这 个 时 期 的 工作 通常 又 称 为 系统 分 析 ， 由 系统 分 析 员 
负 员 完成 。 软 件 定义 时 期 通常 进一步 划分 成 3 个 阶段 ， 即 问题 定义 、 可 行 性 研究 和 需求 
分 析 。 

软件 开发 时 期 具体 设计 和 实现 在 前 一 个 时 期 定义 的 软件 , 它 通常 由 下 述 4 个 阶段 组 成 : 
总 体 设计 、 详 细 设 计 、 编 妈 和 单元 测试 、 综 合 测 试 。 其 中 前 两 个 阶段 义 称 为 系统 设计 ， 后 
两 个 阶段 又 称 为 系统 实现 。 

运行 维护 时 期 的 主要 任务 是 使 软件 持久 地 满足 用 户 的 需要 。 通 第 运行 维护 活动 包括 改 
正 性 维护 、 适 应 性 维护 、 完 善 性 维护 和 预防 性 维护 。 

由 于 本 书 主要 是 探讨 基于 Spring Boot 的 应 用 开发 ,所 以 本 书 介 绍 的 示例 和 案例 主要 说 
明 的 是 如 何 用 Spring Boot HEITIKI Cfi] ff Spring Boot 开发 )。 


2.5.0 Spring Boot 开发 步骤 


Spring Boot 的 开发 步骤 如 下 。 

Step ] : 打开 开发 工具 。 

Step 2: 创建 项 目 。 

Step 3: 根据 情况 判断 是 售 需 要 添加 《〈 补 序 ) 项 目 所 需 的 依赖 ， 如 果 没 有 需要 补充 的 
依赖 则 跳 过 此 步骤 。 

Step 4: 创建 类 和 接口 (按照 实体 类 、 数 据 访 问 接口 和 类 、 业 务 接口 和 类 、 控 制 器 类 
等 顺序 )。 

Step 5: 根据 情况 判断 是 否 需 要 创建 视图 文件 和 CSS 文件 等 ， 如 条 不 需要 则 跳 过 此 

Step 6: 根据 情况 判断 是 个 需要 创建 配置 文件 ， 如 条 不 再 要 则 跳 过 此 步骤 。 

Step 7: 根据 情况 判断 是 否 需 要 图 片 、 语 音 、 视 频 等 文件 ， 如 果 不 需 要 则 跳 过 此 步骤 。 

Step 8: 根据 情况 判断 是 售 震 要 下 载 辅助 文件 、 包 和 安 疫 工具 《如 数据 库 MySQL), 
如 果 不 需 要 则 跳 过 此 步骤 。 由 于 本 书 中 用 到 的 工具 较 多 有 旦 安装 使 用 比较 简单， 本 书 对 此 步 
又 介绍 比较 少 。 

要 注意 的 是 ，Step 3 一 Step 8 的 5 个 步骤 之 间 的 顺序 可 以 互 换 。 完 成 了 Spring Boot FF 
发 之 后 ， 就 可 以 运行 程序 了 。 
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简 答题 
1， 简 述 属性 配置 的 不 同方 法 。 
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2. {HA Spring Boot 的 开发 步骤 。 

安装 开发 工具 IDEA. 

安装 或 配置 开发 工具 STS. 

用 IDEA 实现 Hello World 的 Web 应 用 。 

用 STS 实现 Hello World 的 Web 应 用 。 

以 Hello World 应 用 为 例 ， 用 不 同方 式 实 现 项 目 属性 配置 。 


uU A WwW N = 
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对 第 1 和 章 中 例 1-1 的 代码 进行 分 析 ， 可 以 知道 注解 (Annotation) 在 Spring Boot 开发 
中 占有 重要 的 地 位 。 注 解 为 在 代码 中 添加 信息 提供 了 一 种 形式 化 的 方法 ， 通 过 注解 可 以 很 
方便 地 在 代码 中 某 个 地 方 使 用 被 注解 的 对 象 。 注 解 弟 见 的 作用 包括 生成 文档 、 跟 踩 代 码 依 
赖 性 和 巷 代 配置 文件 、 在 编译 时 进行 格式 检查 (如 Q@Overmde 放 在 方法 前 ) 等 。 

为 了 帮助 读者 更 好 地 理解 后 面 章节 的 示例 代码 ， 本 章 介 绍 Spring Boot 注解 以 及 和 
Spring Boot 注解 密切 相关 的 Java 注解 、Spring 注解 等 内 容 。 


3.1 Java 注解 


JRE 的 库 包 java.lang.annotation 中 代码 包括 注解 相关 的 接口 、 类 等 内 容 。 接 口 
java.lang.annotation.Annotation 是 所 有 上 自 定 义 注解 自动 继承 的 接口 ， 不 需要 定义 时 指定 ， 类 
似 于 所 有 Java 类 都 目 动 继承 的 Object X. 


3.1.4. Java 注解 的 介绍 


注解 是 一 系列 元 数据 ， 它 利用 元 数据 来 解释 、 说 明 程 序 代 人 码 〈 即 被 注解 的 对 象 )。 但 
是 ， 注 解 不 是 所 标注 的 代码 的 组 成 部 分 。 注 解 对 于 代码 的 运行 效果 没有 和 直接 影响 。 注 解 的 
作用 包括 : 

(1) 提供 信息 给 编译 融 ， 编 译 融 可 以 利用 注解 来 探测 错误 和 敬告 信息 。 

(2) 软件 工具 可 以 利用 注解 信息 来 生成 代码 、HTML 文档 或 者 做 其 他 相应 处 理 。 

(3) 运行 时 的 处 理 ， 茶 些 注解 可 以 在 程序 运行 时 接受 代 人 码 的 提取 。 

在 开始 学 习 注 解 具体 语法 之 前 ， 可 以 把 注解 看 成 一 张 标签 。 与 接口 和 类 一 样 ， 注 解 也 
是 一 种 类 型 。 注 解 是 目 Java L5 开始 引入 的 概念 ， 它 允许 开发 者 定义 目 己 的 注解 类 型 和 使 
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用 自 定 义 的 注解 。 注 解 通过 关键 字 @interface 进行 定义 ， 代 码 如 例 3-1 所 示 。 
【 例 3-1】 注解 定义 的 代码 示例 。 
public 8interface TestAnnotation { 
i : 
例 3-1 中 的 代码 目 定义 了 一 个 名 字 为 TestAnnotaion 的 注解 ， 该 注解 目 动 继承 了 类 
java.lang.annotation.Annotation。 创 建 了 目 定义 注解 后 ， 束 可 以 使 用 目 定 义 的 注解 。 注 解 的 
使 用 方法 如 例 3-2 所 示 。 
【 例 3-2】 使 用 目 定 义 注解 的 代码 示例 。 
QTestAnnotation 


public class Test ( 
} 


例 3-2 创建 了 一 个 类 Test， 并 在 类 定义 的 上 方 加 上 了 @TestAnnotation 注解 ， 驳 意味 看 
用 TestAnnotation 注解 了 类 Test。 


d 


3.4.0 Java 的 元 注解 


要 想 更 好 地 使 用 注解 ， 还 需要 理解 元 注解 。 元 注解 是 加 到 注解 上 的 注解 ， 它 的 目的 是 
解释 、 说 明 其 他 普通 注解 。 元 注解 有 @Retention、@Documented、@Target、(@Inherited、 
(QRepeatable 共 5 种 。 

元 注解 @Retention 应 用 到 一 个 注解 时 ， 说 明 该 注解 的 存活 时 间 。 它 的 取 值 包括 
RetentionPolicy.SOURCE , RetentionPolicy.CLASS 、 RetentionPolicy.RUNTIME 。 其中， 
RetentionPolicy.SOURCE 表明 注解 只 在 源 公 阶段 你 留 ， 在 编译 费 进行 编译 时 被 丢弃。 
RetentionPolicy. CLASS 表明 注解 被 保留 到 编译 进行 的 时 候 ， 而 不 会 被 加 载 到 JVM 中 。 
RetentionPolicy.RUNTIME 表明 注解 可 以 保留 到 程序 运行 的 时 候 , 它 会 被 加 载 进 入 JVM H; 
在 程序 运行 时 可 以 获取 到 它们 。 

应 用 元 注解 @Retention 的 代码 示例 如 例 3-3 所 示 , 在 该 示例 中 设 定 注解 TestAnnotation 
可 以 在 程序 运行 时 被 获取 到 。 

【 例 3-3】 应 用 元 注解 @Retention 的 代码 示例 。 

@Retention (RetentionPolicy .RUNTIME) 


public Qinterface TestAnnotation { 
} 


元 注解 @Documented 表示 注解 内 容 会 被 Javadoc 工具 提取 成 文档 ， 文 档 内 容 会 因为 注 
解 内 容 的 不 同 而 不 同 。 

元 注解 @Target 表示 注解 用 于 什么 地 方 ， 如 类 型 、 方 法 和 域 等 。 元 注解 @Target 的 取 
值 包括 ElementType.FIELD、 ElementType.METHOD、  ElementType.PARAMETER , 
ElementType.CONSTRUCTOR 、ElementIype.LOCAL VARIABLE, ElementType.TYPE 、 
ElementType. ANNOTATION TYPE, ElementType.PACKAGE, Hi}, ElementType.FIELD 
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表示 对 字段 、 枚 举 常量 的 注解 ，ElementIType.METHOD 表示 对 方法 的 注解 ， 
ElementType.PARAMETER 表示 对 方法 参数 的 注解 ，ElementType.CONSTRUCTOR 表示 对 
构造 函数 的 注解 ，ElementType.LOCAL VARIABLE 表示 对 局 部 变量 的 注解 ， 
ElementType.ANNOTATION TYPE 表示 对 注解 类 型 的 注解 ，ElementType.PACKAGE 表示 
对 包 的 注解 ，ElementType.TYPE 表示 对 接口 、 类 、 枚 举 、 注 解 等 任意 类 型 的 注解 。 

被 元 注解 @Inherited 注解 过 的 注解 作用 于 父 类 后 ， 子 类 会 日 动 继承 父 类 的 注解 。 应 用 
的 示例 代码 如 例 3-4 所 示 。 

【 例 3-4】 应 用 元 注解 @Inherited 的 代码 示例 。 

// 该 示例 由 3 部 分 组 成 

// 定 义 注 解 

QInherited 


QGRetention (RetentionPolicy.RUNTIME) 
Qinterface Test {} 


cER 


// 在 父 类 中 增加 注解 
QTest 
public class A {} 


// 子 类 B 虽然 没有 明确 给 出 注解 信息 ， 但 是 它 会 继承 父 类 A 中 的 注解 @Test 
public class B extends A {} 


元 注解 @Repeatable 是 在 Java 1.8 中 引入 的 注解 ， 其 应 用 的 示例 代码 如 例 3-5 所 示 。 
Persons 可 以 被 看 作 是 一 张 总 标签 ， 上 和 面 贴 满 了 Person 这 种 同类 型 但 内 容 不 一 样 的 标签 。 
于 是 ， 可 以 同时 给 SuperMan 贴 上 了 画家、 程序 员 、 产 品 经 理 等 标签 《 即 加 上 3 个 注解 )。 

【 例 3-$】 应 用 元 注解 @Repeatable I] fC 375 fil. 


//Persons 是 用 数组 存放 注解 的 容器 注解 ， 它 里 面 必须 要 有 一 个 value 属性 ， 即 数组 
Qinterface Persons { 
Person[] value(); 
} 
//WU RE. £IXINH Persons 注解 
QRepeatable (Persons.class) 
Qinterface Person( 


String role default ""; 


) 

// 不 同属 性 的 Person 注解 
GPerson(role-"artist") 
QPerson(role-"coder") 
QPerson(role-"PM") 
public class SuperMan( 
) 


注解 中 可 以 拥有 属性 (也 叫 作成 员 变量 )， 示 例 代码 如 例 3-6 所 示 。 表 示 目 定义 的 注解 
TestAnnotation 注解 拥有 id 和 msg 两 个 属性 ， 返 回 类 型 分 别 为 Int 和 String. 
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【 例 3-6】 和 市 属性 的 注解 代码 示例 。 


QTarget (ElementType.TYPE) 
QGRetention (RetentionPolicy.RUNTIME) 
public Qinterface TestAnnotation { 
tnr idt); 
String msg(); 
} 


使 用 注解 时 ， 应 该 给 属性 赋值 。 属 性 的 赋值 方法 是 在 注解 后 面 的 括号 内 以 “属性 = 取 
值 ” 的 形式 进行 的 ， 多 个 属性 的 赋值 之 间 用 如 号 阳 开 ， 示 例 代 人 码 如 例 3-7 所 示 。 需 要 注意 
的 是 ， 注 解 中 属性 的 类 型 只 能 是 8 种 基本 数据 类 型 和 类 、 接 口 、 注 解 及 它们 的 数组 。 

【 例 3-7】 给 注解 属性 赋值 的 应 用 代码 示例 。 

QTestAnnotation(id-3,msg-"hello annotation") 


public class Test 1 
} 


注解 中 属性 可 以 有 默认 值 ， 默 认 值 需 要 用 关键 字 default 指定 ， 示 例 代 人 码 如 例 3-8 所 
示 。 注 解 TestAnnotation 中 属性 id 的 默认 值 被 指定 为 -1, 属性 msg 的 默认 值 被 指定 为 "Hi"。 
【 例 3-8】 给 注解 属性 指定 默认 值 的 代码 示例 。 
QTarget (ElementType.TYPE) 
GRetention(RetentionPolicy.RUNTIME) 
public Qinterface TestAnnotation ( 
public int id() default -1; 
public String msg() default "Hi"; 
} 


假如 指定 了 属性 默认 值 ， 可 以 不 用 再 在 注解 TestAnnotation 后 面 的 括号 内 对 属性 进行 
赋值 。 示 例 代 码 如 例 3-9 所 示 。 

【 例 3-9】 属性 有 默认 值 的 注解 应 用 代 人 码 示例 。 

QTestAnnotation() 

public class Test (] 


如 果 注 解 只 有 一 个 属性 时 ， 应 用 这 个 注解 时 则 可 以 省 略 属 性 名 而 将 属性 值 直接 填写 到 
注解 后 面 的 括号 内 ， 如 例 3-10 所 示 。 

【 例 3-10】 单一 属性 注解 简单 应 用 的 代码 示例 。 

HEherki" Hm 

Tnt 


例 3-11 代码 和 例 3-10 代码 的 效果 是 一 样 的 。 
【 例 3-11】 单一 属性 注解 完整 应 用 的 代码 示例 。 


QCheck (value-"hi") 


THECA 
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如 果 一 个 注解 没有 任何 属性 ， 应 用 这 个 注解 时 注解 后 面 的 插 号 则 可 以 省 略 ， 如 例 3-12 
Wr. 

【 例 3-12】 无 属性 注解 的 应 用 代码 示例 。 

QPerform 

public void testMethod()í) 


- 0 


3.1.3 Java 预 置 的 基本 注解 


在 java.lang 包 下 ，Java 预先 提供 了 Deprecated、(@SuppressWarnings、(@Override、 
@SafeVarargs, (@FunctionalInterface J£ 5 个 基本 注解 。 

注解 @Deprecated 是 用 来 标记 过 时 的 元 素 。 编 译 器 在 编译 阶段 遇 到 这 个 注解 时 会 发 出 
提醒 敬告， 告诉 开发 者 正在 调用 一 个 过 时 的 元 素 〈 如 过 时 的 方法 、 类 、 成 员 变 量 )。 

注解 @SuppressWarnings 表示 阻止 警告 的 意思 。 使 用 @Deprecated 注解 后 ， 编 译 器 有 
时 会 给 开发 者 发 出 警告 提醒 ; 当 开 发 者 想 忽略 警告 提醒 时 ， 可 以 通过 @SuppressWarnings 
注解 达到 目的 。@SuppressWarmnings WAX deprecation 〈 表 示 忽 略 使 用 了 过 时 元 素 时 的 
ik), unchecked (表示 忽略 执行 了 未 检查 转换 时 的 警告 )、 fallthrough (表示 忽略 switch. fF 
序 块 直接 通 往 下 一 种 情况 而 没有 break IET). path (表示 忽略 类 路 径 、 源 文件 路 径 等 
路 径 中 有 不 存在 的 路 径 时 的 警告 ) serial( 表 示 忽 略 可 序列 化 的 类 缺少 serialVersionUID jE 
义 时 的 警告 )、finally (表示 忽略 任何 finally TAJA fie IE 28 sé EST IJ ED. all (表示 忽略 
关于 所 有 情况 的 警告 )。 

注解 @Override 表示 了 于 类 要 重 与 父 类 《或 接口 ) 的 对 应 方法 。 如 果 想 重 与 父 类 的 方法 ， 
如 toString0 方 法 ， 则 在 方法 前 面 加 上 @Override， 系 统 可 以 帮助 检查 方法 的 正确 性 。 示 例 
代码 如 例 3-13 所 示 。 

【 例 3-13】 注解 @Override 的 应 用 代码 示例 。 

//&Ooverride 可 以 帮助 检查 方法 的 正确 性 


QOverride 


public String toString()(...) // 这 是 子 类 方法 正确 的 写法 


// 下 面子 类 方法 是 错误 的 ， 有 QOverride， 系 统 可 以 帮助 检查 出 tostring 的 拼写 错误 
QOverride 


public String tostring(Ot..-] 


// 下 面子 类 方法 是 错误 的 ， 由 于 没有 aoverride， 系 统 不 会 帮助 检查 出 tostring 的 拼写 错误 
public String tostring(bi-.-] 


注解 @SafeVarargs 被 用 来 标识 参数 安全 类 型 ， 它 被 用 来 提醒 开发 者 不 要 用 参数 做 一 些 
不 安全 的 操作 ， 它 的 存在 会 阻止 编译 器 产生 unchecked 这 样 的 警告 。 它 是 在 Java 1.7 中 
引入 的 注解 。 

注解 @FunctionalInterface 被 用 来 指定 某 个 接口 必须 是 函数 式 接口 ,否则 就 会 编译 出 错 。 
@FunctionalInterface 是 Java 1.8 引入 的 新 特性 。 如 果 接 口中 有 且 只 有 一 个 抽象 方法 (可 以 
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包含 多 个 默认 方法 或 多 个 static 方法 )， 该 接口 称 为 图 数 式 接口 。 
3.2 Spring 注解 及 注解 注入 


Spring 容器 通过 把 Java 类 注册 成 Bean 的 方式 来 管理 Java 类 。 把 Java 类 变 成 Bean 有 
两 种 方式 : 一 种 方式 通过 XML 配置 把 Java 类 注册 成 Bean; 另 一 种 方式 通过 注解 的 方法 将 
Java 类 注册 成 Bean。 注 解 方式 下 ， 只 再 要 在 Java 类 前 边 加 上 注解 ，Spring 扫描 到 注解 后 
就 会 将 被 注解 的 类 目 动 注册 成 Bean。 利 用 不 同 的 注解 可 以 将 Java 类 注册 成 不 同 的 Bean. 
相对 于 XML 配置 ， 注 解 方法 更 加 方便 、 快 捷 。 于 是 ， 越 来 越 多 的 工具 都 文 持 用 注解 进行 
配置 而 放弃 XML 配置 。 


3.2.1 Spring 基础 注解 


可 以 将 注解 @Component 放 在 类 的 前 面 ， 该 类 被 标注 成 Spring 的 一 个 普通 Bean. 

注解 @Controller 标注 一 个 控制 器 组 件 类 , 它 被 用 来 实现 目 动 检测 类 路 径 下 的 组 件 并 将 
组 件 自动 注册 成 Bean。 例 如 ， 使 用 @Controller 注解 标注 Java 类 UserAction 之 后 ， 就 表示 
要 把 类 UserAction 标注 成 Bean 后 交 给 Spring 容 需 管理 。 如 果 不 指 定 Bean WAF, 按照 约 
定 该 Bean 会 被 命名 为 userAction。 也 可 以 在 注解 后 面 的 括号 内 指定 Bean 的 名 字 ， 例 如 采 
用 @Controller(value="UA") 或 者 @Controller("UA") 的 方法 来 指定 Bean 的 名 字 为 UA. 

注解 @Service 标注 一 个 业务 逻辑 组 件 类 。 例 如 ， 类 Acton 需要 使 用 UserServiceImpl 
实例 时 ， 可 以 用 @Service("userService") 注 解 告诉 Spring 创建 好 一 个 UserServiceImpl 实例 
(名 字 为 userService)。Spring 创建 好 userService 之 后 可 以 将 其 注入 给 Action, Action 就 可 
以 使 用 该 UserServiceImpl 实例 了 。 

注解 @Repository 标注 一 个 DAO 组 件 类 。 可 以 用 @Repository(value="userDao") 注 和 解 告 
VF Spring 创建 一 个 UserDao 实例 〈 名 字 为 userDao)。 当 Service 需要 使 用 userDao 时 ， 可 
以 用 @Resource(name = "userDao") 注 解 告 诉 Spring 把 创建 好 的 userDao 注入 给 Service. 


3.22 Spring 常见 注解 


注解 @Autowired 被 用 来 实现 自动 装配 ，@Autowired 可 以 被 用 来 标注 成 员 变 量 、 方 法 、 
构造 函数 等 对 象 。 虽 然 @Autowired 的 标注 对 象 不 同 ， 但 是 都 会 在 Spring 初始 化 Bean 时 进 
行 目 动 装配 。 使 用 @Autowired 可 以 使 Spring 容器 目 动 搜索 从 合 要 求 的 Bean， 并 将 其 作为 
参数 注入 。 

@Autowired 是 根据 类 型 进行 目 动 装 配 的 ， 示 例 代码 如 例 3-14 所 示 。 如 果 Spring 上 下 
文中 存在 多 个 同类 型 的 Bean 时 〈 如 有 两 个 类 都 实现 了 EmployeeService 接口 )，Spring 不 
知道 应 该 绑 定 哪个 实现 类 ， 就 会 抛 出 BeanCreationException 异常 。 如 果 Spring 上 下 文中 不 
存在 革 个 类 型 的 Bean 时 ， 也 会 抛 出 BeanCreationException E o 
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【 例 3-14】 注解 @Autowired 的 应 用 代码 示例 。 


// 接 口 EmployeeService 声明 
public interface EmployeeService { 
public EmployeeDto getEmployeeById(Long id); 


// 两 个 实现 类 EmployeeServiceImpl Él EmployeeServiceImpll 
QService ("service") 
public class EmployeeServiceImpl implements EmployeeService { 
public EmployeeDto getEmployeeById(Long id) ( 
return new EmployeeDto(); 


} 

QService("servicel") 

public class EmployeeServiceImpll implements EmployeeService { 
public EmployeeDto getEmployeeById(Long id) { 


return new EmployeeDto(); 


// 调 用 接口 实现 类 

@Controller 

@RequestMapping ("/emplayee.do") 
public class EmployeeInfoControl { 


QAutowired // 此 注解 处 会 出 错 ， 因 为 有 两 个 实现 类 ， 而 不 知道 绑 定 哪 一 个 


EmployeeService employeeService; 


QGRequestMapping(params = "method-showEmplayeeInfo") 
public void showEmplayeeInfo(HttpServletRequest request, HttpServletResponse 
response, EmployeeDto dto) { 


…// 代 码 省 略 


} 


可 以 使 用 @Qualifier 配合 @Autowired 来 解决 异常 BeanCreationException， 示 例 代 码 如 


fp] 3-15 所 示 。 


【 例 3-15】 注解 @Qualifier 和 @Autowired 配合 使 用 的 代码 示例 。 


// 接 口 EmployeeService 声明 与 例 3-14 代码 相同 
/ /接口 的 两 个 实现 类 EmployeeServiceImpl fil EmployeeServiceImpll 与 例 3-14 代码 相同 


// 接 口 实现 类 的 调用 
@Controller 
@RequestMapping ("/emplayee.do") 
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public class EmployeeInfoControl { 


QAutowired 
QQualifier ("service") // 新 增加 语句 ， 指 定 调用 第 一 个 接口 实现 类 


EmployeeService employeeService; 


QGRequestMapping(params = "method-showEmplayeeInfo") 
public void showEmplayeeInfo(HttpServletRequest request, HttpServletResponse 
response, EmployeeDto dto) ( 


…// 代 人 码 省 略 
} 
} 


注解 @Resource 可 用 于 标注 一 个 对 象 的 SET 方法 。 注 解 @Resource 的 作用 相当 于 
@Autowired， 只 不 过 @Autowired 按 类 型 目 动 注入 ， 而 @Resource 默认 按 名 字 目 动 注入 。 
JSR-250 标准 推荐 使 用 通用 注解 @Resource RAR Spring 专 有 的 @Autowired 注解 。 

JSR (Java Specification Requests, Java 规范 提案 ) 是 指 问 JCP (Java Community Process) 
提出 新 增 一 个 标准 化 技术 规范 的 正式 请 求 。 任 何人 都 可 以 提交 JSR, Ai Java 平台 增添 新 
的 API 和 服务 。JSR 已 成 为 Java 界 的 一 个 重要 标准 。 从 Spring 2.5 开始 ，Spring 框架 的 核 
4x fy JSR-250 标准 中 注解 @Resource、 注 解 @PostConstruct 和 注解 @PreDestroy。 

@Resource 有 两 个 属性 比较 重要 ， 分 别 是 名 字 name 和 属性 type. Spring 将 @Resource 
注解 name 属性 解析 为 Bean 的 名 字 ， 而 将 type 属性 解析 为 Bean 的 类 型 。 如 果 使 用 name 
属性 ， 则 使 用 按 名 入 目 动 注入 的 注入 策略 ， 而 使 用 type 属性 时 则 使 用 按 类 型 日 动 注入 的 注 
入 乐 略 。 如 果 既 不 指定 name 属性 也 不 指定 type 属性 ， 则 通过 反射 机 制 使 用 按 名 字 目 动 注 
入 的 注入 策略 。@Resource 使 用 按 名 衬 日 动 注 入 的 注入 策略 时 ， 与 使 用 @Qualifier 明确 指 
定 Bean 的 名 称 进行 注入 作用 相同 ,在 众多 相同 的 Bean 中 ,优先 使 用 @Primary 注解 的 Beans 
这 和 人 @Qualifier 有 点 区 别 ，@Qualifier 指 的 是 使 用 哪个 Bean 进行 注入 。 

注解 @PostConstruct 和 注解 @PreDestroy 都 是 JSR-250 标准 的 注解 。 标注 了 @PreDestroy 
的 方法 将 在 类 销毁 之 前 调用 ，@PostConstruct 注解 过 的 方法 将 在 类 实例 化 后 调用 。 

从 Spring 3.0 开始 ,Spring 开始 支持 JSR-330 标准 的 注解 .JSR-330 中 ,@Inject 和 Spring 
中 的 @Autowired 的 职责 相同 ，@Named 和 Spring 中 的 @Component 的 职责 类 似 。 

可 以 用 注解 @Scope 来 定义 Bean 的 作用 范围 ( 称 为 作用 域 ), 也 可 以 通过 在 XML 文件 
中 设置 Bean 的 scope 属性 值 来 实现 这 一 日 的 .@Scope 注解 的 值 可 以 是 singleton、prototype、 
request, session, global session 等 作用 域 ， 默 认 是 单 例 模式 ， 即 scope="singleton"。 其 中 ， 
单 例 模式 singleton 表示 全 局 有 且 仪 有 一 个 实例 ; 原型 模式 prototype 表示 每 次 获取 Bean 时 
都 会 有 一 个 新 的 实例 ; request 表示 针对 每 一 次 HTTP 请 求 都 会 产生 一 个 新 的 Bean, ifj Hic 
Bean 仅 在 当前 HTTP 请 求 内 有 效 ; session 表示 针对 每 一 次 HTTP 请 求 都 会 产生 一 个 新 的 
Bean， 而 且 该 Bean 仅 在 当前 HTTP session 内 有 效 ; global session 类 似 于 标准 的 HTTP 
sesslon， 不 过 它 仅 仅 在 基于 Portlet 的 Web 应 用 中 才 有 意义 。Portlet 的 请 求 处 理 分 为 action 
阶段 和 render 阶段 。 在 一 个 请 求 中 ，action 阶段 只 执行 一 次 ， 但 是 render 阶段 可 能 由 于 用 
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户 的 浏览 器 操作 而 被 执行 多 次 。Portlet 规范 定义 了 global session 的 概念 ， 它 被 所 有 构成 某 
个 Portlet Web 应 用 的 各 种 不 同 Portlet 所 共享 fr global session 中 定义 的 Bean 被 限定 于 
Portlet 企 局 会 话 Cglobalsession) 的 生命 周期 范围 内 。 如 果 在 Web 中 使 用 global session 来 
标识 Bean, JRA Web 会 目 动 当成 session 类 型 来 使 用 。 

JSR-330 默认 的 作用 域 类 似 Spring 的 prototype, JSR-330 标准 中 的 Bean 在 Spring 中 默 
认 也 是 单 例 的 。 如 果 要 使 用 非 单 例 的 作用 域 ， 开 发 者 应 该 使 用 Spring 的 @Scope 注解 。 
JSR-330 也 提供 了 一 个 @Scope 注解 ， 然 而 ， 这 个 注解 仅仅 在 用 来 创建 目 定 义 的 作用 域 时 才 
能 使 用 。 

注解 @RequestMapping 为 类 或 方法 指定 一 个 映射 路 径 ， 可 以 通过 指定 的 路 径 来 访问 对 
应 的 类 或 方法 ， 应 用 示例 如 例 3-16 HR. HF, userid 值 通过 @PathVariable 注解 方法 进行 
绑 定 。 注 解 @PathVariable 主要 用 来 获取 单一 的 URI 参数 ， 如 果 想 通过 URI 传输 一 些 复杂 
的 参数 ， 则 要 考虑 使 用 注解 @MatrixVariable。(@MatrixVariable 的 矩阵 变量 可 以 出 现在 URI 
中 任何 地 方 ， 变 量 之 间 用 分 号 CO 分 隔 。@MatrixVariable 默认 是 不 启用 的 ， 启 用 它 时 需 
要 将 enable-matrix-variables 设置 为 true. 

【 例 3-16】 注解 @RequestMapping 的 应 用 代码 示例 。 


@RequestMapping (value-"/getName/[(userid)", method = RequestMethod.GET) 


— < 


public void login(8PathVariable String userid, Model model)q( 
) 


注解 @RequestParam 将 请 求 中 市 的 值 赋 给 被 注解 的 方法 参数 。 如 例 3-17 所 示 ， 把 请 求 
中 的 值 username 赋 给 方法 中 username 这 个 参数 。 属性 required 代表 参数 是 否 必 须 赋值 ， 默 
认为 true; 当 不 能 确定 请 求 中 是 否 有 值 可 以 赋 给 参数 时 ,就 必须 把 属性 required 设置 为 false。 

【 例 3-17】 注解 @RequestParam 的 应 用 代 人 码 示 例 。 

public void login(8RequestParam(value-"username" required-"true")String 


username) { 


} 


不 管 是 HTTP 请 求 还 是 HTTP 响应 都 是 通过 报 文 传输 的 ， 而 报 文 都 有 头 和 正文 。 头 包 
舍 服 务 站 或 者 客户 痛 的 一 些 信息 ， 用 来 表明 身份 、 提 供 验 证 或 限制 等 。 正 文 是 要 传递 的 内 
容 。 注 解 @RequestBody 把 请 求 报 文中 的 正文 目 动 转换 成 绑 定 给 方法 参数 的 变量 字符 串 。 
响应 请 求 时 ，@ResponseBody 将 内 容 或 Java 对象 转换 成 响应 报 文 的 正文 返回 。 当 返回 的 数 
据 不 是 HTML 标记 页 面 (视图) 而 是 其 他 东 种 格式 数据 〈 如 JSON, XML 等 ) 时 ， 才 使 用 
(QRequestBody 注解 。 

注解 @Param 表示 对 参数 的 解释 ， 一 般 写 在 注释 里 面 。 

注解 @JoinTable 表示 Java 类 和 数据 库 表 的 映射 关系 ,也 可 以 标识 列 的 映射 、 主 键 的 映 
射 等 。 

注解 @Transational 是 Spring 事务 管理 的 注解 ,被 @Transational 注解 的 方法 或 类 目 动 被 
注册 成 事务 ， 接 受 Spring 容 髓 的 管理 。 

注解 @Syschronized 表示 实现 Java 同步 机 制 ， 用 它 作 注解 相当 于 加 同步 锁 。 
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注解 @ModelAttribute 声明 在 属性 上 ， 表 示 该 属性 的 值 来 源 于 model 里 queryBean， 并 
被 保存 到 model 里 。 注 解 @ModelAttribute 声明 在 方法 上 ， 表 示 该 方法 的 返回 值 被 保存 到 
model 里 。 

注解 @Cacheable 表明 一 个 方法 的 返回 值 应 该 被 缓存 ,注解 @CacheFlush 声明 一 个 方法 
是 清空 绥 存 的 触发 融 ， 这 册 个 注解 要 配合 缓存 处 理 右 使 用 。 

Spring 允许 指定 ModelMap 中 哪些 属性 需要 转 存 到 会 话 中 ， 以 便 下 一 个 请 求 还 能 访问 
到 这 些 属性 。 注 解 @SessionAttributes 只 能 标注 类 ， 而 不 能 标注 方法 。 

如 果 希 望 东 个 属性 编辑 费 仅 作用 于 特定 的 控制 费 Controller, 可 以 在 Controller 中 定义 
一 个 被 注解 @InitBinder 标注 的 方法 , 可 以 在 该 方法 中 间 Controller 注册 奎 干 个 属性 编辑 右 。 

注解 @ Required 负责 检 答 一 个 Bean 在 初始 化 时 其 SET 方法 是 人 否 被 执行 ,如果 SET 7j 
法 没有 被 调用 ， 则 Spring 在 解析 时 会 抛 出 异 音 来 提醒 开发 者 设置 对 应 的 属性 。 (QRequired 
注解 只 能 标注 在 SET 方法 上 上， 如果 将 其 标注 在 非 SET 方法 上 束 会 被 忽略 。 

Spring 4.0 中 引入 了 条 件 化 配置 特性 ， 提 供 了 更 加 通用 的 基于 条 件 的 Bean 创建 方法 ; 
即使 用 @Conditional 注解 。@Conditional 根据 满足 某 一 特定 条 件 创建 一 个 特定 的 Bean。 条 
件 化 配置 允许 配置 存在 于 应 用 程序 中 ， 但 在 满足 条 些 特定 条 件 之 前 部 忽略 这 些 配 置 。 在 
Spring 里 可 以 很 方便 地 编写 日 定义 的 条 件 , 只 需要 实现 Condition 接口 并 复壮 它 的 matches() 
方法 ; 如 例 3-18 所 示 。 在 例 3-18 F, HA JdbcTemplateCondition 类 的 条 件 成 立时 才 会 
创建 MyService 这 个 Bean. FN), IXA Bean 的 声明 就 会 被 忽略 掉 。 

【 例 3-18】 注解 @Conditional 的 应 用 代码 示例 。 

// 具 体 条 件 类 ， 需 实现 Condition 接口 ， 并 重 写 matches (... ，...) 方 法 

public class JdbcTemplateCondition implements Condition { 

QOverride 
public boolean matches (ConditionContext context, 
AnnotatedTypeMetadata metadata) ( 
Eryvi 
context.getClassLoader().loadClass( 
"org.springframework.jdbc.core.JdbcTemplate"); 
return true; 
) catch (Exception e)( 
return false; 
} 


// 声 明 bean 时 ， 使 用 自 定 义 条 件 类 ， 作 为 @Conditional 的 参数 value 
@Conditional (JdbcTemplateCondition.class) 
public MyService myService()(...) 


} 


3.23 Spring 的 注解 注入 
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@Resource, @Qualifier, @Service, @Controller, @Repository, @Component 等 。 其 中 ， 
注解 @Anutowired 实现 自动 注入 ， 注 解 @Resource 通过 指定 名 称 的 方式 进行 注入 。 注 解 
@Qualifier 和 注解 @Autowired 配合 使 用 , 通过 指定 名 称 的 方式 进行 注入 。 注 解 @Autowired、 
(QResource 可 以 被 用 来 标注 字段 、 构 造 函 数 、 方 法 ， 并 进行 注入 。 

注解 @Service、@Controller、@Repository 被 用 来 标注 类 ，Spring 扫描 注解 标注 的 类 时 
要 生成 的 Bean。 注 解 @Service、@Controlletr、@Repository 标注 的 类 分 别 位 于 服务 层 、 控 
制 屋 、 数 据 存储 层 。 注 解 @Component 是 一 种 泛 指 ， 标 记 被 注解 的 对 象 是 组 件 。 

注解 @EnableAspectJAutoProxy 表示 开局 AOP 代理 目 动 配置 机 制 ， 可 以 通过 设置 
@EnableAspectJAutoProxy(exposeProxy=true) 表 示 使 用 AOP 框架 来 暴露 该 代理 对 象 ， 这 样 
aopContext 就 能 够 访问 。 从 注解 @EnableAspectJAutoProxy 的 定义 可 以 看 出 , 它 引 入 了 一 个 
AspectJAutoProxyRegister.class 对 象 ， 该 对 象 是 一 个 用 @EnableAspecUAutoProxy 注解 标注 
的 AnnotationAwareAspectJAutoProxyCreator. 

AnnotationAwareAspectJAutoProxyCreator 能 通过 调用 类 AopConfigUtils 的 方法 
registerAspectJAnnotationAutoProxyCreatorIfNecessary(registry) 来 注册 一 个 AOP 代理 对 象 生 
DER 

注解 @Profiles 提供 了 一 种 隅 离 应 用 配置 的 方法 ， 让 这 些 配置 上 只 能 在 特定 环境 下 生效 。 
任何 组 件 或 配置 类 都 能 被 @Profiles 标记 ， 从 而 限制 它们 的 加 载 时 机 。 


3.3 Spring Boot 的 注解 


3.3.1 Spring Boot 基础 注解 


注解 @SprngBootApplicaton 和 注解 @Configuraton (g)EnableAutoConfiguration 、 
(Q)ComponentScan 注解 等 价 。 其 中 , 注解 @Configuration 标注 在 类 上 , 等 同 于 Spring 的 XML 
配置 文件 中 Bean。 注 解 @EnableAutoConfiguration 实现 自动 配置 。 注 解 @ComponentScan 
扫描 组 件 ， 可 自动 发 现 和 装配 Bean， 并 把 Bean 加 入 到 程序 上 下 文 。 

注解 @RestController 是 注解 @Controller 和 注解 @ResponseBody 的 合集 ， 表 示 被 标注 
的 对 象 是 REST 风格 的 Bean， 并 且 是 将 方法 的 返回 值 直接 填 入 HTTP. 响应 正文 中 返回 给 
用 户 。 

注解 @JsonBackReference 可 以 用 来 解决 无 限 递 归 调 用 问题 。 注 解 @RepositoryRest- 
Resource 配合 spring-boot-starter-data-rest 使 用 ， 用 于 创建 RESTful 入 口 点 。 注 解 @Import 
用 来 导入 其 他 配置 类 。 注 解 @ImportResource 用 来 加 载 XML 配置 文件 。 

注解 @Bean 标注 方法 等 价 于 XML 配置 中 的 Bean。 注 解 @Value 注入 Spring Boot 配置 
文件 application.properties 中 配置 的 属性 值 。 注 解 @Inject 等 价 于 默认 的 @Autowired， 只 是 
没有 required 属性 。 

Spring Boot 定义 了 很 多 条 件 ， 将 其 运用 到 了 配置 类 上 ， 这 些 配 置 类 构成 了 Spring Boot 
的 目 动 配置 。Spring Boot 提供 的 条 件 化 注解 包括 @ConditionalOnBean (配置 了 某 个 特定 
Bean )、(@ConditionalOnMissingBean (没有 配置 特定 的 Bean), (@ConditionalOnClass 
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(classpath 目录 里 有 指定 的 类 )、@ConditionalOnMissingClass (classpath 目录 里 缺少 指定 的 
类 )、@ConditionalOnExpression( 给 定 的 SPEL 表达 式 计算 结果 为 true)、@ConditionalOnJava 
(Java 的 版 本 匹配 特定 值 或 者 一 个 范围 值 )，@ConditionalOnJndi (参数 中 给 定 的 JNDI 位置 
必须 存在 一 个 )、@ConditionalOnProperty (指定 的 配置 属性 要 有 一 个 明确 的 值 )、 
@ConditionalOnResource (classpath 目录 有 指定 的 资源 )、@ConditionalOnWebApplication 
(是 一 个 Web 应 用 程序 )、@ConditionalOnNotWebApplication (不 是 一 个 Web 应 用 程序 )。 


3.3.3 JPA 注解 


注解 @Entity 表明 被 标注 的 对 象 是 一 个 实体 类 , 注解 @TIableCame='" ") 指 出 实体 对 应 的 
表 名 ; 这 两 个 注解 一 般 一 起 使 用 。 但 是 如 果 表 名 和 实体 类 名 相同 ， 则 @Table 可 以 省 略 。 

进行 开发 项 目 时 ， 经 弟 会 用 到 将 实体 类 映射 到 数据 库 表 的 操作 。 有 时 需要 映射 的 几 个 
实体 类 有 共同 的 属性 ， 例 如 编号 ID、 创 建 者 、 创 建 时 间 、 备 注 等 。 这 时 ， 可 以 把 这 些 属性 
抽象 成 一 个 父 关 ， 然 后 各 个 实体 类 继承 这 个 父 类 。 可 以 使 用 @MappedSuperclass 注解 标注 
父 类 ， 它 不 会 映射 到 数据 库 表 ， 但 子 类 在 映射 时 会 目 动 扫描 父 类 的 映射 属性 ， 并 将 这 些 属 
性 添加 到 子 类 对 应 的 数据 库 表 中 。 使 用 @MappedSuperclass 注解 后 不 能 再 有 @Entity 或 
(Q) Table 注解 。 

Spring Data 中 提供 了 很 多 DAO 接口 ， 但 是 依然 有 可 能 满足 不 了 日 党 应 用 的 需要 ， 需 
H HE X. Repository 实现 。 注解 @NoRepositoryBean 一 般 用 作 父 类 的 Repository， 有 这 个 注 
解 Spring 不 会 去 实例 化 该 Repository。 

注解 @Column 标识 实体 关中 属性 与 数据 表 中 字段 的 对 应 关系 。 如 果 注 解 @Column 的 
字段 名 与 列 名 相同 ， 则 可 以 省 略 。@Column 注解 一 共有 10 个 属性 ， 这 10 个 属性 均 为 可 选 
BHE. Ha tEA name, unique, nullable, table, length, precision, scale 等 。 其 中 ，name 
属性 定义 了 被 标注 学 段 在 数据 库 表 中 所 对 应 字段 的 名 称 。unique TES CEP Buen A E 
一 标识 ， 默 认 值 为 false。 如 果 表 中 有 一 个 字段 需要 唯一 标识 ， 则 既 可 以 使 用 该 标记 ， 也 可 
以 使 用 @Table 标记 中 的 @UniqueConstraint。nullable 属性 表示 该 字段 是 否 可 以 为 null 值 ， 
SUEN true. table 属性 定义 了 包含 当前 字段 的 表 名 。length 属性 表示 字段 的 长 度 ， 当 字 
段 的 类 型 为 varchar 时 ， 该 属性 才 有 效 ; 默认 值 为 255 NFIF. precision 属性 和 scale 属性 
表示 精度 ， 当 字段 类 型 为 double I], precision 表示 数值 的 总 长 度 ，scale 表示 小 数 点 所 占 的 

注解 @Id 用 于 声明 一 个 实体 类 的 属性 映射 为 数据 库 的 主键 列 。 该 属性 通 音 置 于 属性 声 
明 语句 之 前 ， 可 与 声明 语句 同行 ， 也 可 与 在 单独 行 上 。@Id 标注 也 可 置 于 属性 的 getter 方 
法 之 前 。 

注解 @GeneratedValue 用 于 标注 主键 的 生成 策略 ， 通 过 属性 strategy 指定 策略 。 例 如 ， 
注解 @GeneratedValue(strategy = GenerationType. SEQUENCE) 表示 主键 生成 策略 是 
sequence, (Q)GeneratedValue(generator ='"Trepair seq") 指 定 sequence 的 名 字 是 repair seq。 在 
javax.persistence.GenerationType 中 定义 了 IDENTITY、AUTO、SEQUENCE 等 几 种 可 供 选 
择 的 策略 。 其中, IDENTITY REKRAI E ID 目 增长 的 方式 来 目 增 主键 字段 , Oracle 
不 文 持 这 种 方式 ; SEQUENCE 表示 通过 序列 产生 主键 ， 通 过 @SequenceGenerator 注解 指 
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定 序 列 名 ，MySQL 不 文 持 这 种 方式 。 默 认 情 况 下 ，JPA 日 动 选择 一 个 最 适合 的 的 层 数 据 库 
的 主键 生成 策略 ， 例 如 SOL Server 对 应 的 默认 策略 为 identity, MySQL 对 应 的 默认 策略 为 
auto Increment。 注 解 @SequenceGeneretor(name -"repair seq", sequenceName -"seq repair", 
allocationSize = ]) 中 name 7j sequence 的 名 称 , 以 便 使 用 ;sequenceName 为 数据 库 的 sequence 
名 称 ， 两 个 名 称 可 以 一 致 。 

注解 @Transient 表示 被 标注 的 属性 不 是 一 个 到 数据 库 表 的 字段 的 映射 ， 对 象 天 系 映 射 
(Object Relational Mapping, ORM) 框架 将 忽略 该 属性 。 如 果 一 个 属性 并 非 数 据 库 表 的 字 
段 映 射 ， 就 务必 将 其 标示 为 @Transient; 否则 ，ORM 框架 默认 其 注解 为 @Basic。 注 解 
@Basic(fetch=FetchType.LAZY) 可 以 指定 实体 属性 的 加 载 方式 。 

注解 @JsonIgnore 的 作用 是 JSON 序列 化 时 将 Java Bean 中 的 一 些 属性 忽略 挥 ， 序 列 化 
和 反 订 列 化 都 受 影 响 。 例 如 ， 如 果 硕 望 返 回 的 JSON 数据 中 不 包含 属性 goodsInfo 和 
extendsInfo 快照 值 ; 在 实体 类 快照 属性 上 加 注解 @JsonIgnore 即 可 , 最 后 返回 的 JSON 数据 
将 不 会 包含 goodsInfo 和 extendsInfo 两 个 属性 值 。 

注解 @JoinColumn (name-"loginld") 表示 一 张 表 有 指 同 男 一 个 表 的 外 键 。 假 设 Person 
表 和 Address 表 是 一 对 一 的 关系 ，Person 有 一 个 指 问 Address 表 主 键 的 字段 addressID; 可 
以 用 注解 @JomColumn 注解 addressID。(@OneToOne、(@OneToMany、(@ManyToOne.、 
(üManyToMany 对 应 Hbemate 配置 文件 中 的 一 对 一 、 一 对 多 、 多 对 一 、 多 对 多 关系 。 
@ManyToOne 不 产生 中 间 表 ， 可 以 用 @Joincolumn (name-" ") 来 指定 外 键 的 名 字 。 
(QOneToMany 会 产生 中 间 表 ， 可 以 用 @onetoMany @Joincolumn (name-" ") 避免 产生 中 间 
表 ， 并 且 能 指定 外 键 的 名 字 。 


3.3.3 异 向 处 理 注解 


注解 @ControllerAdvice 包含 注解 @Component， 可 以 被 扫描 到 ， 统 一 处 理 异 常 。 
注解 @ExceptionHandler (Exception.class) 用 在 方法 上 面 表示 过 到 这 个 异 背 束 执 行 所 注 
解 的 方法 。 


3.3.4 注解 配置 解析 和 使 用 环境 


注解 @PreUpdate 用 于 为 相应 的 生命 周期 事件 指定 回调 方法 。 该 注解 可 以 应 用 于 实体 
类 、 了 映射 超 类 或 回调 监听 器 类 的 方法 。 如 果 要 每 次 更 新 实体 时 都 要 更 新 属性 ， 可 以 使 用 注 
解 @PreUpdate 注释 。 注 解 @PreUpdate 不 允许 更 改 实体 。 

注解 @PrePersist 帮助 在 持久 化 之 前 目 动 填充 实体 属性 ,(@PrePersist 事件 在 调用 persist( 
方法 后 立刻 发 生 ， 此 时 的 数据 还 没有 真正 插入 数据 库 。 可 以 用 来 在 使 用 JPA 时 记录 一 些 与 
业务 无 关 的 字段 ， 如 最 后 更 新 时 间 等 。 生 命 周 期 方法 注解 “删除 没有 生命 周期 事件 ) 
(QPrePersist 在 保存 之 前 被 调用 ， 注 解 @PostPersist 在 保存 之 后 被 调用 。@PostPersist 事件 
在 数据 已 经 插入 数据 库 后 发 生 。 

注解 @PostLoad 在 Entity 被 映射 之 后 被 调用 , 注解 @EntityListeners 指定 外 部 生命 周 
期 事件 实现 类 。 注 解 @PostLoad 事件 在 执行 EntityManager.find() 或 getreference() 方 法 载 入 


第 3 章 Spring Boot 的 相关 注解 39 


一 个 实体 后 、 执 行 JPA SQL 查询 后 或 EntityManager refresh(0 方 法 被 调用 后 执行 。 

注解 @PreRemove 和 注解 @PostRemove 事件 的 触发 由 删除 实体 引起 。 注 解 @PreRemove 
事件 在 实体 从 数据 库 删 除 之 前 触发 。 注 解 @PostRemove 事件 在 实体 从 数据 库 中 删除 后 
触发 。 

注解 @NoArgsConstructor 提供 一 个 无 参 的 构造 方法 。 注 和 解 @AllArgsConstructor 提供 一 
个 全 参 的 构造 方法 。 


- 
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简 答 题 
1. R Java 常用 注解 的 含义 、 用 法 和 功能 。 
2. È Spring 常用 注解 的 含义 、 用 法 和 功能 。 


第 4 章 


Spring Boot 的 Web 应 用 开发 


Web 应 用 开发 是 现代 软件 开发 中 重要 的 一 部 分 .Spring Boot 的 Web JF7z WI tik f. Servlet 
和 服务 器 ， 并 结合 Spring MVC 来 完成 开发 。 本 章 主 要 介绍 向 单 的 Web 应 用 开发 ， 包 括 如 
何 实 现 静 态 Web 页 面 ， 如 何 实 现 基于 Thymeleaf 的 动态 Web 页 面 ，Thymeleaf 的 语法 与 使 
用 ， 如 何 实现 基于 Freemarker 的 Web 应 用 ， 如 何 实 现 对 Ajax 的 应 用 ， 如 何 实现 RESTful 
风格 Web 应 用 ， 如 何 实现 带 Bootstrap 41 jQuery 的 Web 应 用 ， 如 何 实现 使 用 Servlet、 过 滤 
需 、 监 听 堪 和 拦截 器 的 Web 应 用 开发 。 


4. 实现 静态 Web 页 面 


4.1.1 创建 类 GreetingController 视频 讲解 


在 第 2 章 项 目的 基础 上 ， 在 controller 包 中 创建 一 个 GreetingController 类 ， 代 码 如 
例 4-1 所 示 。 该 代码 和 HelloWorldController 文件 的 作用 相同 (返回 字符 串 )， 这 是 注解 
@RestController 所 起 的 作用 。 而 注解 @GetMapping 和 HelloWorldController 文件 中 的 注解 
(QRequestMapping 作用 基本 相同 ， 主 要 是 用 于 在 URL 中 作为 映射 信息 ， 区 别 仅 在 于 
@GetMapping 强调 采用 的 是 GET 方法 获取 信息 。 

【 例 4-1】 创建 类 GreetingController 的 代码 示例 。 


package com.bookcode.controller; 
import org.springframework.web.bind.annotation.GetMapping; 


import org.springframework.web.bind.annotation.RestController; 


QRestController // 返 回 的 默认 结果 为 字符 串 
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public class GreetingController { 
QGGetMapping ("/greeting") / /映射 信息 ， 且 采用 的 是 GET 方法 获取 信息 
public String greeting() ( 


return "greeting"; 


4.1.2 创建 文件 index.html 


在 项 目的 src/main/resources/staic 目录 下 创建 文件 index.html, RE 4nff| 4-2 所 示 。 
【 例 4-2] 创建 文件 index.html 的 代码 示例 。 


«!DOCTYPE html» 
«head» 
«title»Getting Started: Serving Web Content«/title» 
«meta http-equiv-"Content-Type" content-"text/html; charset-UTF-8" /» 
«/head» 
«body» 
«p»Hello from the static index.html file.«/p» 
«/body» 
«/html» 


4.1.3 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8888/website/greeting， 结 果 如 图 4-1 所 示 。 


y [A localhost:8888/website X 


€ C | © localhost:8888/website/greeting 


greeting 


图 4-1 Ev aH d localhost:8888/website/greeting 的 结果 
在 浏览 器 中 输入 localhost:8888/website/index.html 后 ， 结 果 如 图 4-2 所 示 。 


y [] Getting Started: Servin: X 


€ > C |O localhost:8888/website/index.html 


Hello from the static index.html file. 


图 4-2 在 浏览 器 中 输入 localhost:8888/website/index.html 的 结果 


index.html 是 默认 的 启动 页 面 ， 在 浏览 器 中 输入 localhost:8888/website/ 后 ， 结 果 如 
图 4-3 所 示 (和 图 4-2 相同 )。 


— < 
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Getting Started: Servin: X 


€ G | © localhost:8888/website/ 


Hello from the static index.html file. 


图 4-3 ”在 浏览 器 中 输入 localhost:8888/website/I1] Z5 4 


4.2 ”实现 基于 Thymeleaf 的 Web 应 用 


在 Spring Boot 中 ， 推 荐 使 用 Thymeleaf 作为 动态 Web 页 面 〈 视 图 ) 的 
模板 引擎 。 因 此 ， 本 书 示 例 中 的 视图 主要 是 基于 Thymeleaf 实现 的 。 视频 讲解 


4.2.1 添加 依赖 


在 pom.xml 文件 中 ， 在 <dependencles> 和 </dependenclies> 之 间 添 加 Thymeleaf 依赖 ， 代 
码 如 例 4-3 所 示 。 
【 例 4-3】 在 pom.xml 文件 中 添加 Thymeleaf 依赖 的 代码 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-thymeleaf«/artifactId» 
«/dependency» 


4.2.2 ”修改 类 GreetingController 


修改 类 GreetingController 后 ， 代 人 码 如 例 4-4 所 示 。 在 例 4-4 中 ， 注 解 @ResponseBody 
表示 该 方法 返回 的 结果 直接 写 入 HTTP 响应 正文 中 ， 返 回 的 是 字符 串 。 使 用 注解 
(QRequestMapping 后 ， 返 回 值 通 营 解析 为 跳 转 路 径 。 注 解 @Controller 返回 的 是 视图 ， 它 
和 注解 @Responsebody 组 合 在 一 起 相当 于 注解 @RestController。 注 解 @RequestParam 表示 
输入 参数 name 信息 ， 在 例 4-4 中 参数 name 的 的 认 取 值 为 World， 而 且 参 数 不 是 必需 的 
(required=false ) 。 


【 例 4-4】 修改 类 GreetingController 的 代码 示例 。 


package com.bookcode.controller; 
import org.springframework.stereotype.Controller; 
import org.springframework.ui.Model; 
import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.RequestParam; 
import org.springframework.web.bind.annotation.ResponseBody; 
(Controller // 返 回 的 默认 结果 为 视图 ， 此 例子 中 即 是 HTML 文件 
public class GreetingController { 
QGetMapping ("/greeting") // 映 射 信息 ， 访 问 方法 为 GET 方法 
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QGResponseBody / /f&i& f eController 的 返回 要 求 ， 返 回 结果 是 字符 串 
public String greeting() { 
System.out.println("Hello"); 
return "greeting"; 
} ! 
QGetMapping ("/hi") // 映 射 信息 ， 访 问 方法 为 GET 方法 
public String hi(8RequestParam(name-"name", required-false, defaultValue- 
"World")String name, Model model) ( 
model.addAttribute("name", name); 


Felner "hr*. // 返 回 的 是 视图 , 即 返 回 位 于 templates 目录 下 的 hi.html 


— 


4.2.3 创建 文件 hi.html 


在 项 目 目录 src/main/resources/templates 下 创建 文件 hihtml， 代 码 如 例 4-5 所 示 。 
【 例 4-$S】 创建 文件 hihtml 的 代码 示例 。 


«'DOCTYPE html» 
«1—-thymeleaf 的 命名 空间 --> 
<html xmlns:th-"http://www.thymeleaf.org"» 
<head> 
«title»Getting Started: Serving Web Content«/title» 
«meta http-equiv-"Content-Type" content-"text/html; charset-UTF-8" /» 
</head> 
<body> 
<!--${name} 获 取 GreetingController 类 中 的 name 变量 信息 并 输出 --> 
«p th:text-"'Hello, ' + ${name} + '!'" /> 
«/body» 
«/html» 


424 ”运行 程序 


运行 程序 后 在 浏览 器 中 输入 localhost:8080/hi?name=zs， 结 果 如 图 4-4 所 示 。 请 注意 将 
im HO KA 8080。 


T Getting Started: Servin: X N 


z E © localhost:8080/hi?name-zs 


Hello, zs! 


图 4-4 在 浏览 器 中 输入 localhost:8080/hi?name-zs 的 结果 


在 浏览 器 中 输入 localhost:8080/hi, 结果 如 图 4-5 所 示 。 此 时 ， 参 数 name 将 选择 
默认 值 World。 关 于 参数 name 的 默认 值 请 结合 例 4-4 的 代码 来 分 析 。 
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/ Ø Getting Started: Servin: X NY 


€ G | G) localhost:8080/hi 


Hello, World! 


图 4-5 在 浏览 器 中 输入 localhost:8080/hi 的 运行 结果 


4.5 Thymeleaf 的 语法 与 使 用 


由 于 Spring Boot 开发 中 推荐 使 用 的 视图 是 基于 Thymeleaf 的 ,本 节 人 简要 介绍 Thymeleaf 
的 语法 与 使 用 。 


4.3.1 Thymeleaf 基础 知识 


Thymeleaf 是 一 个 模板 引擎 ， 以 使 显示 由 应 用 程序 生成 的 数据 或 文本 。 它 适合 在 Web 
应 用 程序 中 为 HTML 5 提供 服务 , 也 可 以 处 理 任何 XML 文件 。Ihymeleaf 具有 “ 开 箱 即 用 ” 
的 特点 ; 允许 处 理 XML 、HTML、JavaScript、CSS、 普 通 文本 等 模板 ， 每 种 模板 都 称 为 模 
板 模 式 。 

Thymeleaf 命名 空间 被 声明 为 了 h:* 属 性 ， 代 人 码 例 4-6 所 示 。 

【 例 4-6】 Thymeleaf 命名 空间 的 声明 代码 示例 。 


«html xmlns:th="http://www.thymeleaf.org"> 


对 文本 进行 外 部 化 是 将 模板 代码 户 段 从 模板 文件 中 提取 出 来 ， 以 便 将 它们 保存 在 特定 
的 单独 文件 (通常 是 .properties 文件 ) 中 ， 并 且 可 以 用 其 他 语言 〈 称 为 国际 化 或 简称 118n) 
编写 的 等 效 文本 蔡 换 它们 。 外 部 化 的 文本 卢 段 通 利 称 为 消息 。 消 有 息 总 是 有 一 个 标识 它们 的 
键 。Ihymeleaf 允许 指定 一 个 文本 以 对 应 于 一 个 特定 的 消 县 ，#{…} 语 法 如 例 4-7 HZR. 

【 例 4-7】 Thymeleaf 中 #{…} 语 法 的 应 用 代 人 码 示 例 。 


«p th:text="#{home.welcome}">Welcome to our grocery store!</p> 


4.3. Thymeleaf 的 标准 表达 式 


Thymeleaf 的 标准 表达 式 主 要 包括 以 下 8 K. 

1l. 简单 表达 式 

(OD 变量 表达 式 : ${…}。 

(2) 选择 变量 表达 式 : *{…}。 

(3) 消息 表达 式 : #{*…}。 

(4) 链接 URL 表达 式 : @{…}。 这 里 URL 包括 绝对 网 址 (如 http://www.thymeleaf.org ) 
和 相对 网 址 (如 user/login.html)。 
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2. 字面 量 

(1) 文本 : 'onetext', 'Another one!' 等 。 

(2) 数值 ，0，4，3.0，12.4 等 。 

(3) 布尔 值 : true，false。 

(4) ZF: null, 

(5) 标记 : one, sometext, other 等 。 

3. 文本 操作 

(D 字符 串 连 接 : +。 

(2) XR k: |The name is $fname}|。 

4. 算术 运算 

(D 二 元 运算 ，+，-，*，/，% 等 。 

(2) 一 元 运算 : —. 

5. 布尔 运算 

(1) 二 元 运算 : and，or。 

(2) 布尔 否定 (一 元 运算 ): l, not. 

6. 比较 和 等 价 

(1) 比较 : >, <, >=, <, gt, lt, ge, le 等 。 
(2) 等 价 ; =, !=, eq, ne 等 。 

7. 条 件 运 算 操 作 

(1) IF-THEN: (1f)? (then). 

(2) IF-THEN-ELSE: (if) ? (then) : (else). 

(3) WIRE: (value) ?: (defaultvalue). 

8. 特殊 标记 

无 操作 : _。 

所 有 这 些 功 能 可 以 组 合 和 风 套 ， 例 4-8 涵盖 了 上 述 大 部 分 表达 式 。 
【 例 4-8】 Thymeleaf 标准 表达 式 的 应 用 代码 示例 。 


'User is of type ' + (${user.isAdmin()} ? 'Administrator' : (${user.type} ?: 


< “> 


'Unknown')) 


4.3.3 Thymeleaf 的 表达 式 对 象 


可 以 使 用 ${…} 语 法 表示 一 个 变量 表达 式 的 值 。 例 4-9 的 代码 包含 一 个 名 为 OGNL (对 
象 图 寻 航 语言 ) 的 语言 表达 式 ， 将 在 上 下 文 变 量 映 射 上 执行 。 

【 例 4-9】 Thymeleaf 中 $ 人 语法 的 应 用 代码 示例 。 

«p»Today is: «span th:text="${today}">13 February 2011«/span»«/p» 

变量 表达 式 不 仅 可 以 写成 ${…} 表 达 式 ， 还 可 以 写 入 表达 式 *{…} 中 。 不 过 ， 星 号 〈*) 


表示 所 选 对 象 上 的 表达 式 ， 而 不 是 整个 上 下 文 变 量 的 映射 。 
在 上 下 文 变量 上 使 用 OGNL 表达 式 时 ， 一 些 对 和 象 可 用 于 表达 式 以 获得 更 大 的 灵活 性 。 
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这 些 对 象 将 锌 引用， 从 # 符 号 开始 。 
#ctx 表示 上 下 文 对 象 。 
#vars 表示 上 下 文 变量 。 
locale 表示 上 下 文 语 言 环境 。 
#request 表示 《只 在 Web 上 下 文中 ) HttpServletRequest 对 象 。 
"response 表示 (只 在 Web 上 下 文中 ) HttpServletResponse 对 象 。 
Zsession 表示 (只 在 Web 上 下 文中 ) HttpSession 对 象 。 
ZservletContext 表示 (只 在 Web 上 下 文中 ) ServletContext 对 象 。 
示例 代码 如 例 4-10 所 示 。 
【 例 4-10】 # 的 应 用 代码 示例 。 


国家 : «span th:text="${#locale.country}">US</span> 


全 A 


除了 这 些 基本 的 对 象 之 外 ，Thymeleaf 还 提供 了 一 套 实 用 对 象 ， 帮 助 实现 在 表达 式 中 
TA T$ WESS. 

#dates 表示 java.util.Date 对 象 的 实用 方法 (格式 化 ， 组 件 提取 等 )。 

#calendars 表示 java.util.Calendars 对 象 的 实用 方法 。 

#numbers 表示 格式 化 数字 对 象 的 实用 方法 。 

#strings 表示 String 对 象 的 实用 方法 (contains、startsWith、prepending、appending 等 )。 

objects 表示 一 般 对 象 的 实用 方法 。 

#bools 表示 布尔 评估 的 实用 方法 。 

Zarrays 表示 数组 的 实用 方法 。 

#lists 表示 列表 的 实用 方法 。 

sets 表示 集合 的 实用 方法 。 

#maps 表示 地 图 的 实用 方法 。 

Zaggregates 表示 用 于 在 数组 或 集合 上 创建 聚合 的 实用 方法 。 

#messages 表示 用 于 在 变量 表达 式 中 获得 外 部 消 奶 的 实用 方法 ， 与 使 用 #{…} 语 法 获得 
的 方式 相同 。 

#ids 表示 用 于 处 理 可 能 重复 的 id 属性 的 实用 方法 (例如 ， 作 为 近代 的 结果 )。 

代码 例 4-11 所 示 。 

【 例 4-11] Thymeleaf 中 实用 对 和 象 的 应 用 代码 示例 。 

今天 是 :<span th:text-"$(fcalendars.format(today,'dd MMMM yyyy'))"»55 May 

2018«/span» 


4.3.4 Thymeleaf 设置 属性 


可 以 使 用 也 :* 任 务 设置 特定 标签 属性 的 属性 (而 不 仅仅 是 任何 属性 也 :attr)， 这 些 属性 
如 下 所 示 。 


th:abbr th:accept th:accept-charset 
th:accesskey th:action th:align 

th:alt th:archive th:audio 
th:autocomplete th:axis th:background 
th:bgcolor th:border th:cellpadding 
th:cellspacing th:challenge th:charset 
th:cite th:class th:classid 
th:codebase th:codetype th:cols 
th:colspan th:compact th:content 
th:contenteditable th:contextmenu th:data 
th:datetime th:dir th:draggable 
th:dropzone th:enctype th:for 

th:form th:formaction th:formenctype 
th:formmethod th:formtarget th:frame 
th:frameborder th:headers th:height 
th:high th:href th:hreflang 
th:hspace th:http-equiv th:icon 

th:id th:keytype th:kind 
th:label th:lang th:list 
th:longdesc th:low th:manifest 
th:marginheight th:marginwidth th:max 
th:maxlength th:media th:method 
th:min th:name th:optimum 
th:pattern th:placeholder th:poster 
th:preload th:radiogroup th:rel 

th:rev th:rows th:rowspan 
th:rules th:sandbox th:scheme 
th:scope th:scrolling th:size 
th:sizes th:span th:spellcheck 
th:src th:srclang th:standby 
th:start th:step th:style 
th:summary th:tabindex th:target 
th:title th:type th:usemap 
th:value th:valuetype th:vspace 
th-width th:wrap th:xmlbase 
th:xmllang th:xmlspace 
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有 了 两 个 比较 特殊 的 属性 为 了 h:alt-title (将 同时 设置 alt 和 title 属性) 和 th:lang-xmllang 
(将 同时 设置 lang 和 xml:lang 属性 )。 
另外 ， 存 在 一 些 具 有 固定 值 布 尔 属性 ， 如 下 所 示 。 没 有 值 的 属性 意味 看 属性 值 为 true. 
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th:async th:autofocus th:autoplay 
th:checked th:controls th:declare 
th:default th:defer th:disabled 

$ th:formnovalidate th:hidden th:ismap 

4 th:loop th:multiple th:novalidate 
th:nowrap th:open th:pubdate 
th:readonly th:required th:reversed 
th:scoped th:seamless th:selected 


4.3.5 Thymeleaf 的 迭代 和 条 件 语句 


为 了 在 Web 页 面 上 列 出 菜 个 企业 生成 的 全 部 产品 ,需要 用 到 表格 ,每 个 产品 都 将 显示 
在 一 行 。 所 以 ，Thymeleaf HARJA, Thymeleaf 为 此 提供 了 一 个 属性 th:each 。 
Thymeleaf 用 th:each 提供 了 一 个 有 用 的 机 制 来 跟 中 具有 连 代 状态 的 状态 变量 。 状 态 变 量 在 
一 个 th:each 属性 中 定义 并 包含 以 下 变量 。 
(1) index p np VR M 0 开始 计数 。 
(2) count 表示 当前 迭代 索引 ， 从 1 开始 计数 。 
(3) size JO TAE EP IT] JG RR Ae 
(4) current 表示 每 个 迭代 的 iter 变量 。 
(5) 布尔 值 even/odd 表示 目前 的 迭代 是 偶数 还 是 奇数 。 
(6) 布尔 值 frst 表示 目前 的 迭代 是 否 是 第 一 个 。 
C7) 布尔 值 last 表示 目前 的 友 代 是 人 否 是 最 后 一 个 。 
代 但 如 例 4-12 所 示 。 
【 例 4-12 】 Thymeleaf FIKAR NL FIF 3 DU 
«table» 
cLre 
<th> 产 品名 称 </th> 
<th> 产 品 价格 </th> 
<th> 产 品 库 存 </th> 
<I Er> 
<tr th:each="prod, iterStat : ${prods}" th:class="${iterStat.odd}? 'odd'"> 
«td th:text="$ {prod.name}">Onions</td> 
«td th:text-"$(prod.pricej"»2.41«/td» 
«td th:text-"$(prod.inStock)? £(true) : #{false}">yes</td> 
«Er» 
«/table» 


条 件 语句 和 一 般 编程 语言 类 似 ， 代 码 如 例 4-13 所 示 。 
【 例 4-13] Thymeleaf 中 条 件 语句 应 用 的 代码 示例 。 


«a href-"comments.html" 
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th:href-"Q(/product/comments (prodId-$[(prod.id]))" 
th:if="$ {not 4lists.isEmpty(prod.comments)])"»view«c/a» 
«a href-"comments.html" 
th:href-"8(/comments (prodId=$ {prod.1d})}" 
th:unless="$ {#11ists.1isEmpty (prod.comments) }">view</a> 


cH 


«div Ekh-:swibLch-"Siuser:ralel]"» 
«p th:case-"'admin'"»User is an administrator«c/p» 
«p th:case-"£(roles.managerj"»User is a managerc/p» 
«/div» 


4.3.6 Thymeleaf 模板 片段 的 定义 和 引用 


因为 Jackson JSON 处 理 库 位 于 类 路 径 classpath 中 , 模板 RestTemplate 将 使 用 它 (通过 
消息 转换 器 ) 将 传 入 的 JSON 数据 转换 为 Quote 对 象 。 接 着 ，Quote 对 象 的 内 容 被 作为 日 
志 信 息 发 送 到 控制 台 。 

在 Web 中 可 能 需要 在 模板 中 包含 其 他 模板 片段 , 常见 的 用 途 是 在 不 同 的 页 和 面 中 添加 固 
定 的 页 脚 、 标 题 、 荣 单 等 片段 。 为 了 做 到 这 一 点 ，Thymeleaf 需要 先 定 义 可 用 于 包含 的 万 
段 ， 可 以 通过 使 用 th:fragment 属性 来 完成 。 例 如 ， 将 一 个 版 权 页 脚 添加 到 所 有 某 个 Web 
页 面 时 ， 需 要 先 定义 一 个 版 权 页 脚 片 段 (footer.html)， 代 人 码 如 例 4-14 Pros 

【 例 4-14】 Thymeleaf 中 模板 片段 定义 的 代 人 码 示 例 。 


«!DOCTYPE html SYSTEM "http://www.thymeleaf.org/dtd/xhtmll-strict- 
thymeleaf-4.dtd"» 
«html xml1ns-"http: //www.w3.0rg/1999/xhtml" xmlns:th-"http://www.thymeleaf.org"» 
«body» 
«div th:fragment-"copy"» 
&copy; 2011 The Good Thymes Virtual Grocery 
«/div» 
«/body» 
</html> 


接着 ， 可 以 在 Web 页 面 中 使 用 也 :insert、th:include 或 者 也 :replace 属性 来 包含 页 脚 片 


段 ， 代 码 如 例 4-15 所 示 。 
【 例 4-15] Thymeleaf 中 引用 模板 片段 的 代码 示例 。 
<body> 
<div th:insert="footer :: copy"></div> 
<div th:include="footer :: copy"></div> 
<div th:replace="footer :: copy"></div> 
</body> 


th:include 将 用 指定 片段 替换 主 标签 ，th:include 将 用 片段 的 实际 内 容 奉 换 主 标签 ， 
th:replace 将 用 实际 片段 蔡 换 主 标签 。 
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4.4 实现 基于 Freemarker 的 Web 应 用 


Freemarker 是 一 球 模 板 引 擎 ， 用 来 生成 输出 文本 (HTML 网 页 、 电 子 邮 
4 ” 件 、 配 置 文件 、 源 代码 等 ) 的 通用 工具 。 它 不 是 面 癌 最 终 用 户 的 ， 而 是 一 个 
Java 类 库 ， 是 一 于 程序 员 可 以 艇 入 他 们 所 开发 产品 的 组 件 。Freemarker 模板 
编写 语言 (Freemarker Template Language, FTL) 是 简单 、 专 用 的 语言 。 在 模板 中 主要 关 
注 如 何 展现 数据 ， 而 在 模板 外 关注 要 展示 什么 数据 。Thymeleaf 和 Freemarker 在 一 个 项 目 
中 能 起 到 相同 的 作用 ， 即 作为 视图 显示 结果 ， 而 且 它 们 可 以 在 一 个 项 目 中 共存 。 


Bea 


4.4.1 ”添加 依赖 


在 pom.xml 文件 中 ， 在 <dependencies> 和 </dependencies> 之 间 添 加 Freemarker 依赖 ， 
代码 如 例 4-16 所 示 。 
【 例 4-16】 添加 Freemarker 依赖 的 代码 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-freemarker«/artifactId» 
</dependency> 


4.4.2 ”创建 类 TemplateController 


在 包 com.bookcode 下 创建 子 包 controller, J- com.bookcode.controller 包 中 创建 类 
TemplateController， 代 人 码 如 例 4-17 所 示 。 
【 例 4-17】 创建 类 TemplateController 的 代码 示例 。 


package com.bookcode.controller; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.RequestMapping; 
import java.util.Map; 
QGController 
public class TemplateController { 
QRequestMapping ("/helloFtl") 
public String helloFtl(Map«String,Object» map) { 
map.put ("hello", "基于 Freemarker from TemplateController.helloFtl"); 
return"/helloFtl"; 


44.3 创建 文件 helloFt.ftl 


在 resources/templates 目录 下 ， 创 建文 件 helloFtlLfl， 代 码 如 例 4-18 所 示 。 
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【 例 4-18】 创建 文件 helloFtl.fd 的 代码 示例 。 


«'!DOCTYPE html» 
«html xmlns-"http://www.w3.org/1999/xhtml"» 
«head» 
«title»Hello World!«/title» 
</head> 
<body> 
«hl»5Hello.v.2«/h1» 
«p»$ (hello)«/p» 
</body> 
</html> 


444 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 127.0.0.1:8080/helloFtl， 结 果 如 图 4-6 所 示 。 


/ei Hello World! x \\ 


€ > CO 12700.1:8080/helloFti 


Hello.v.2 


基于 Freemarker from TemplateController.helloFtl 


图 4-6 在 浏览 器 中 输入 127.0.0.1:8080/helloFtl 的 结果 


4.5 Spring Boot 对 Ajax 的 应 用 


Ajax E|! Asynchronous JavaScript And XML (异步 JavaScript 和 XML )， i 
症 指 一 种 创建 快速 、 动 态 、 交 互 式 Web 应 用 的 开发 技术 。 不 使 用 Ajax 的 传 ”视频 讲解 
统 网 页 如 果 需 要 更 新 内 容 , 则 必须 重 载 整个 页 面 。 通过 在 后 台 与 服务 锅 进 行 
少量 数据 交换 ,Ajax 可 以 使 网 页 实现 异步 更 新 。 这 意味 着 可 以 在 不 重新 加 载 整个 网 页 的 情 
况 下 ， 对 网 页 的 东部 分 进行 更 新 。 


4.5.1 创建 类 HelloWorldA jaxController 


在 包 com.bookcode.controller 中 创建 类 HelloWorldAjaxController, 代码 如 例 4-19 所 示 。 
【 例 4-19] 创建 类 HelloWorldAjaxController 的 代码 示例 。 


package com.bookcode.controller; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 
QGRestController 
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@RequestMapping ("/ajax") 
public class HelloWorldAjaxController { 
QGRequestMapping ("/hello") 
public String say()( 
return "('messagel':'SpringBoot 你 好 ', 'message2', ' 你 好 Ajax'}"; 


4.5.2 ”创建 文件 index.html 


在 resources/static 目录 下 创建 文件 index.html， 代 码 如 例 4-20 所 示 。 
【 例 4-20】 创建 文件 index.html 的 代码 示例 。 


«!DOCTYPE html» 
«html» 
«head» 
«meta charset-"UTF-8"» 
«title»Insert title here«c/title» 
«script src-"http://www.javal234.com/jquery-easyui-1.3.3/jquery.min.js"»«/script» 
«script type-"text/javascript"» 
function show()( 
$.post ("ajax/hello",(j,function (result)( 
alert(result); 
)); 
} 
«/script» 
«/head» 
«body» 
«button onclick-"show()"»Ajax 测试 按钮 </button> 
</body> 
</html> 


4.5.3 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/index.html; 单 击 “Ajax 测试 按钮 ”按钮 ， 


弹出 对 话 杠 ， 结 果 如 图 4-7 所 示 。 


/ gi Insert title here Xx V 


€ QC | © localhost:8080/index.html 


Ajax 测 试 按 钮 localhost:8080 显示 


[message1:SpringBoot 你 好 , message2 ,你 好 Ajax 


图 4-7 在 浏览 器 中 输入 localhost:8080/index.html 后 单 击 “Ajax 测试 按钮 ”按钮 的 结果 
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4.6 Spring Boot 实现 RESTful 风格 Web 应 用 


REST( Representational State Transfer ) 摘 述 了 一 个 架构 样式 的 网 络 系统 ， 
如 Web 应 用 程序 。 REST 指 的 是 一 组 架构 约束 条 件 和 原则 , 满足 这 些 约束 条 ”视频 讲解 
件 和 原则 的 应 用 程序 或 设计 就 是 RESTful。Web 应 用 程序 最 重要 的 REST 原则 是 客户 端 和 
服务 占 之 间 的 交互 在 请 求 之 间 是 无 状态 的 。 从 客户 端 到 服务 占 的 每 个 请 求 都 必须 包含 理解 
请 求 所 必需 的 信息 。 此 外 ， 无 状态 请 求 可 以 由 任何 可 用 服务 器 回答 ， 客 户 闹 可 以 缓存 数据 
以 改进 性 能 。 服 务 器 病 的 应 用 程序 状态 和 功能 可 以 分 为 各 种 资源 ， 币 见 的 资源 包括 应 用 程 
序 对 象 、 数 据 库 记 录 、 算 法 等 。 每 个 资源 都 使 用 URI (Universal Resource Identifier) 得 到 
一 个 唯一 的 地 址 。 所 有 资源 都 共 孚 统一 的 接口 ， 以 便 在 客户 靖 和 服务 器 之 间 传 输 状 态 。 传 
得 使 用 的 方法 是 标准 的 HTTP 方法 ， 如 GET. PUT. POST 和 DELETE. 


4.6.1 创建 类 BlogController 


在 包 com.bookcode.controller 中 创建 类 BlogController， 代 人 码 如 例 4-21 所 示 。 
【 例 4-21] 创建 类 BlogController 的 代码 示例 。 


package com.bookcode.controller; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.PathVariable; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestParam; 
import org.springframework.web.servlet.ModelAndView; 
QGController 
QGRequestMapping ("/blog") 
public class BlogController { 
GRequestMapping ("/(id)") 
public ModelAndView show (@PathVariable ("id") Integer id)( 
ModelAndView mav-new ModelAndView(); 
mav.addObject("id", id); 
mav.setViewName ("blog"); 
return mav; 
} 
QRequestMapping ("/query") 
public ModelAndView query ((RequestParam(value-"q",required-false)String 9q){ 
ModelAndView mav-new ModelAndView(); 
mav.addObject ("q", q); 
mav.setViewName ("query"); 


return mav; 
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4.6.2 ”创建 文件 index.html 


在 resources/static 目录 下 创建 文件 index.html， 代 人 码 如 例 4-22 所 示 。 
【 例 4-22】 创建 文件 index.html 的 代码 示例 。 


<I DOCTYPE html» 
<html> 
<head> 
«meta charset-"UTF-8"» 
«title»Insert title here«c/title» 
«script src-"http://www.javal234.com/jquery-easyui-1.3.3/jquery.min.js"» 
«/script» 
«script type-"text/javascript"» 
function show()( 
$.post ("ajax/hello",(j,function (result)( 
alert (result); 
2 
) 
«/script» 
</head> 
<body> 
<button onclick-"show()"»Ajax 测试 按钮 </button><br/> 
hret "DIO 2I bi 
«a href="/blog/query?q=123456"> 搜 索 </a> 
</body> 
«/html» 


4.6.58 创建 文件 blog.html 


在 resources/templates 目录 下 创建 文件 blog.html， 代 人 码 如 例 4-23 所 示 。 
【 例 4-23】 创建 文件 blog.html 的 代码 示例 。 


«!DOCTYPE html» 
«html xmlns:th-"http://www.thymeleaf.org"» 
«head» 
«title»Getting Started: Serving Web Content«/title» 
«meta http-equiv-"Content-Type" content-"text/html; charset-UTF-8" /» 
</head> 
<body> 
«p th-text" ' WAS- « S(id) 9 '!'" /» 
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«/body» 
«/html» 


4.6.1 创建 文件 query.html 


— < 


在 resources/templates 目录 下 创建 文件 query.html， 代 码 如 例 4-24 所 示 。 
【 例 4-24】 创建 文件 query.html 的 代码 示例 。 


«'!DOCTYPE html» 
«html xmlns:th-"http://www.thymeleaf.org"» 
«head» 
«title»Getting Started: Serving Web Content«/title» 
«meta http-equiv-"Content-Type" content-"text/html; charset-UTF-8" /» 
</head> 
<body> 
epobhsbexp-" t a ESO E a 4S 
«/body» 
«/html» 


4.6.5 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/index.html， 结 果 如 图 4-8 所 示 。 单 击 “ 博 
客 ” 链 接 后 ， 结 果 如 网 4-9 所 示 。 单 击 “ 搜 索 ” 链 接 后 ， 结 果 如 图 4-10 所 示 。 对 比例 4-21 
中 类 BlogController 的 代码 和 例 4-19， 可 以 发 现 BlogController 类 没有 实现 访问 路 径 
/ajax/hello 对 应 的 方法 ， 因 此 单 击 图 4-8 中 的 “Ajax 测试 按钮 ”按钮 后 没有 任何 反应 。 


/ gy Insert title here 


c > C | © localhost:8080/index.html 


€ > CŒ |O localhost:8080/blog/21 


博客 编号 :21! 


图 4-9 单 击 “ 博 客 ” 链 接 后 的 结果 


— < 
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/ Ø Getting Started: Servin: X V 


V o—— 
| 
| 


€ C | © localhost:8080/blog/query?q- 123456 


查询 , 123456! 


图 4-10 单 击 “ 搜 索 ” 链 接 后 的 结果 


4.7 带 Bootstrap 和 jQuery 的 Web 应 用 


视频 讲解 


Bootstrap 是 比较 受 欢 迎 的 前 痛 组 件 库 之 一 ,可 以 用 于 开发 啊 应 式 布 局 、 
移动 设备 优先 的 Web 项 目 。Bootstrap 是 一 套用 于 HTML, CSS 和 JavaScript 开发 的 开源 
工具 集 。Bootstrap FER T FEH Web HF, 利用 这 些 组 件 可 以 快速 地 搭建 一 个 深 亮 、 功 
能 完备 的 网 站 。 了 Bootstrap PESHA FHRA, EHA E FAKA FA FA 
和 条、 路径 导航 、 分 页 、 排 版 、 缩 略图 、 警 告 对 话 框 、 进 度 条 、 媒 体 对 象 等 。 

jQuery 是 一 个 快速 .简洁 的 JavaScript 框 架 , 是 继 Prototype 之 后 又 一 个 优秀 的 JavaScript 
[X Eg CEEX JavaScript 框架 )。]jQuery 设计 的 宗 自 是 “Wnte Less, Do More”， 即 倡导 写 更 
少 的 代码 做 更 多 的 事情 。 它 封装 了 JavaScript 第 用 的 功能 代码 ， 提 供 一 种 简便 的 JavaScript 
设计 模式 ， 优 化 了 HTML 文档 操作 、 事 件 处 理 、 动 画 设 计 和 Ajax ZH.. jQuery 的 核心 特 
性 可 以 总 结 为 : 具有 独特 的 链 式 语法 和 短小 清晰 的 多 功能 接口 ; 具有 融 效 灵活 的 CSS 选择 
器 ， 并 且 可 对 CSS 选择 器 进行 扩展 ; 拥有 便捷 的 插件 扩展 机 制 和 丰富 的 插件 ， 兼容 各 种 主 
IRI L AF 0 


4.7.1 添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ， 代 码 如 例 4-25 
Br. 
【 例 4-25] Web 和 Thymeleaf f [f] [3 7j 9 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 
«/dependency» 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-thymeleaf«/artifactId» 
«/dependency» 


4.7.20 ”创建 类 Person 


在 包 com.bookcode.entity 中 创建 类 Person, RE tii] 4-26 所 示 。 
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【 例 4-26】 创建 类 Person 的 代码 示例 。 


4.7.3 创建 类 BJController 


在 包 com.bookcode.controller 中 创建 类 BJController， 代 人 码 如 例 4-27 所 示 。 
【 例 4-27】 创建 类 BJController 的 代码 示例 。 
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import java.util.ArrayList; 


import java.util.List; 


(Controller 
public class BJController { 
$ @RequestMapping ("/") 
t public String index (Model model) { 


Person single = new Person("jk-—",11,"Í&kM"); 
List«Person» people = new ArrayList«Person»(); 
Person pl ~ new Person("^7E[",11,"iLJ^"); 
Person p2 = new Person(" 主 五 ", 22,. "湖北 "); 
Person p3 = new Person("fX3t",33,"lb5i"); 
people.add(pl); 

people.add(p2); 

people.add(p3); 
model.addAttribute("singlePerson", single); 
model.addAttribute("people", people); 


return "index": 


4.7.4 添加 辅助 文件 


下 载 Bootstrap, jQuery 并 将 它们 添加 到 项 目 中 resources/static 目录 下 , 如 图 4-11 所 示 。 


v Msrc 


v B main 


v java 
v Bcom.bookcode 
> B controller 
> B entity 
$$ DemoApplication 


v resources 
v D static 
> 5 bootstrap 
v Bjs 
v i jquery-3.3.1.js 
198 Iquery-3.3.1.min.js 
v B templates 


aa index.html 


图 4-11 在 项 目 中 添加 Bootstrap, jQuery 等 辅助 文件 后 的 结果 


47.5 创建 文件 index.html 


在 resources/templates 目录 下 创建 文件 mdex.html， 代 码 如 例 4-28 所 示 。 
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【 例 4-28】 创建 文件 index.html 的 代码 示例 。 


<!DOCTYPE html» 
<html xmlns:th-"http://www.thymeleaf.org"» 
«head» 
«meta content-"text/html;charset-UTF-8"/» 
«meta http-equiv-"X-UA-Compatible" content-"IE-edge"/» 


«meta name-"viewport" content-"width-device-width, initial-scale-1"/» 


«link th:href-"8 (bootstrap/css/bootstrap.css)" rel-"stylesheet"/» 
</head> 
<body> 
<div class="panel panel-primary"> 
«div class-"panel-heading"» 
<h3 class-"panel-title"»]j|] model«/h3» 
«/div» 
«div class-"panel-body"» 
«span th:text-"$(singlePerson.name)"»«/span» 
«/div» 
«/div» 
«div th:if-"$(not 4lists.isEmpty (people) }"> 
«div class-"panel panel-primary"» 
«div class-"panel-heading"» 
<h3 class-"panel-title"»7Z|4«/h3» 
«/div» 
«div class-"panel-body"» 
«ul class-"list-group"» 
«li class-"list-group-item" th:each-"person:$(people)]"» 
«span th:text-"$(person.name]"»5«/span» 
«span th:text-"$(person.agej"»«/span» 
«span th:text-"$(person.address)"»«/span» 


«button class="btn" th:onclick-2"'getName(M'' + $(person.name] + 


'à1);'"»3k8 A F«/button» 
«/li» 
«/ul» 
«/div» 
«/div» 
«/div» 


«script th:src-"Q(js/jquery-3.3.1.min.js)" type-"text/javascript"»«/script» 


Wo uu ELS 
«script th:src-"Q((bootstrap/js/bootstrap.min.js)"»«/script»«!-- 2 --» 
«script th:inline-"javascript"» 

var single = [[$[(singlePerson]]]; 


console.log(single.name-"/"«single.age-"/"-c-single.address) 
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function getName (name) { 
console.log (name); 
} 
«/script» 
</body> 
</html> 


- < 


47.6 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080， 并 单 击 “获得 名 字 ” 按 钮 后 ， 结 果 如 
图 4-12 所 示 。 


€ e | (D localhost:3080 


访问 model 
BK 
列表 


O Selected context only 


李 四 11 江苏 ”获得 名 字 张 三 /11/ 徐 州 


Cn 22 湖北 ”获得 和 名字 


钱 进 33 北京 “获得 名 字 


图 4-12 在 浏览 器 中 输入 localhost:8080 并 单 击 “ 获 得 名 字 ” 按 钮 后 的 结果 


4.8 使 用 Servlet, Wiers MITRA EERS 


Java Servlet (Server Applet) 是 用 Java 编写 的 服务 器 端 程 序 ， 主 要 功能 
在 于 交互 式 地 浏览 和 修改 数据 并 生成 动态 Web 内 容 。 狭 义 的 Servlet 是 指 ”视频 讲解 
Java 语言 实现 的 一 个 接口 ， 广 义 的 Servlet 是 指 任何 实现 了 这 个 Servlet 接口 的 类 ， 一 般 情 
况 下 人 们 将 Servlet 理解 为 后 者 。Servlet 运行 在 文 持 Java 的 应 用 服务 器 中 。 从 理论 上 讲 ， 
Servlet 可 以 啊 应 任何 类 型 的 请 求 , 但 绝 大 多 数 情况 下 Servlet 只 用 来 扩展 基于 HTTP 的 Web 
服务 器 。 

过 滤 堪 依赖 于 Servlet RF, JÆ Java EE 标准 ; 在 请 求 进入 容器 之 后 还 未 进入 Servlet 
之 前 进行 预 处 理 ， 并 且 在 请 求 结束 返 回 给 前 问 之 前 进行 后 期 处 理 。 过 小 占 的 实现 基于 函数 
回调 ， 它 可 以 对 几乎 所 有 请 求 进 行 过 滤 。 其 缺点 是 一 个 过 滤 堪 实例 只 能 在 容器 初始 化 时 调 
用 一 次 。 使 用 过 滤器 的 目的 是 做 一 些 过 滤 操 作 或 修改 HttpServletRequest 的 参数 ， 如 修改 字 
符 编 码 、 过 滤 低 俗 文字 和 和 危险 字符 等 。 

监听 器 是 一 个 实现 特定 接口 的 普通 Java 程序 ， 这 个 程序 专门 用 于 监听 另 一 个 Java 
对 象 的 方法 调用 或 者 属性 改变 。 当 被 监听 对 象 发 生 上 述 事件 后 ， 监 听 喜 的 茶 个 方法 将 立即 
执行 。 
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拦截 器 不 依赖 于 Servlet 容器 ,依赖 于 具体 的 Web 框架 , 在 Spring MVC 中 就 是 依赖 于 
Spring MVC 框架 。 在 实现 上 基于 Java 的 反射 机 制 ， 属 于 面 问 切面 编程 CAOPO 的 一 种 运 
用 。 由 于 拦截 器 是 基于 Web 框架 的 调用 ， 因 此 可 以 使 用 Spring 的 依赖 注入 CDD. 获取 IoC 
容器 中 的 各 个 Bean， 进 行业 务 操作 。 一 个 拦截 器 实例 在 一 个 控制 器 生命 周期 之 内 可 以 多 次 / 
调用 ， 但 是 只 能 对 控制 器 请 求 进行 拦截 。 


4.8.1 创建 类 MyServletl 


创建 类 MyServlet1， 代 码 如 例 4-29 所 示 。 
【 例 4-29】 创建 类 MyServletl 的 代码 示例 。 


package com.bookcode.servlet; 

import javax.servlet.ServletException; 

import javax.servlet.http.HttpServlet; 

import javax.servlet.http.HttpServletRequest; 

import javax.servlet.http.HttpServletResponse; 

import java.io.IOException; 

import java.io.PrintWriter; 

public class MyServletl extends HttpServlet { 
QOverride 
protected void doGet (HttpServletRequest req, HttpServletResponse resp) 
throws ServletException, 

IOException { 

System.out.println("»»5»5»5»5»»»»»doGet ()«««««««««««"); 
doPost(req, resp): 
} 
QOverride 
protected void doPost (HttpServletRequest req, HttpServletResponse resp) 
throws ServletException, 

IOException { 
System.out.println("»»5»5»5»5»»»»»doPost ()«««««««««««"); 
resp.setContentType ("text/html"); 
resp.setCharacterEncoding ("utf-8"); 

PrintWriter out - resp.getWriter(); 
out.println("«html»"); 
out.println("«head»"); 
out.println("«title»Hello World«/title»"); 
out.println("«c/head»"); 
out.println("«body»"); 
out.println("«h1l»iX7É: MyServletl«c«/h1»"); 
out.println("«/body»"); 


62 — Spring Boot 开发 实战 一 一 微 课 视 频 版 


out.println("«/html»"); 


t 4.8.2 ”修改 人 口 类 1 


修改 入 口 类 ， 代 码 如 例 4-30 所 示 。 
【 例 4-30】 修改 入 口 类 DemoApplication I fV 437r 9 ; 


package com.bookcode; 
import com.bookcode.servlet.MyServletl!; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.boot.web.servlet.ServletRegistrationBean; 
import org.springframework.context.annotation.Bean; 
QGSpringBootApplication 
public class DemoApplication { 

QBean 

public ServletRegistrationBean MyServletl()( 

return new ServletRegistrationBean (new MyServletl(),"/myServlet/*"); 
} 
public static void main(String[] args) ( 


SpringApplication.run(DemoApplication.class, args); 


48.3 ”运行 程序 1 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/myServlet， 结 果 如 图 4-13 所 示 。 


/ 2» Hello World 


E C | © localhost:8080/myServlet 


这 是 : MyServlet1 


K|4-13 在 浏览 器 中 输入 localhost:8080/myServlet 后 的 结果 


4.8.4 创建 类 MyServlet2 


创建 类 MyServlet2， 代 人 码 如 例 4-31 所 示 。 
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【 例 4-31] 创建 类 MyServlet2 的 代码 示例 。 


package com.bookcode.servlet; 


import 
import 
import 
import 
import 
import 


import 


javax.servlet.ServletException; 
javax.servlet.annotation.WebServlet; 
javax.servlet.http.HttpServlet; 
javax.servlet.http.HttpServletRequest; 
javax.servlet.http.HttpServletResponse; 
java.io.IOException; 


java.io.PrintWriter; 


QWebServlet (urlPatterns-"/myServlet2/*", description-"Servlet 的 说 明 ") 


public 


class MyServlet2 extends HttpServlet { 


QGOverride 


protected void doGet(HttpServletRequest req, HttpServletResponse resp) 


throws ServletException, 


} 


IOException { 
System.out.println("»»5»5»5»5»5»»»»doGet ()«««««««««««") ; 
doPost (req, resp): 


QOverride 


protected void doPost (HttpServletRequest req, HttpServletResponse resp) 


throws ServletException, 


4.8.5 


IOException { 
System.out.println("»»5»5»5»5»»»»»doPost ()«««««««««««"); 
resp.setContentType ("text/html"); 
resp.setCharacterEncoding ("utf-8"); 
PrintWriter out - resp.getWriter(); 
out.println("«html»"); 
out.println("«head»"); 
out.println("«title»Hello World«/title»"); 
out.println("«c/head»"); 
out.println("«body»"); 
out.println("«hl»iX7É: MyServlet2«/hl»"); 
out.println("«/body»"); 
out.println("«/html»"); 


修改 人 口 类 2 


修改 入 口 类 ， 代 码 如 例 4-32 所 示 。 
【 例 4-32] 修改 入 口 类 的 代码 示例 。 


package com.bookcode; 


import org.springframework.boot.SpringApplication; 
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import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.boot.web.servlet.ServletComponentScan; 
QGSpringBootApplication 
QServletComponentScan 
public class DemoApplication { 
public static void main(String[] args) ( 
SpringApplication.run(DemoApplication.class, args); 


48.6 “运行 程序 2 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/myServlet2， 结 果 如 图 4-14 所 示 。 对 比 


例 4-30 和 例 4-32 代码 ， 可 以 发 现 :; 前 者 是 用 @Bean 注解 注入 Servlet 类 ， 而 后 者 采用 
(QServletComponentScan 注解 目 动 扫 摘 Servlet 类 。 


/中 Hello World x \ 


€ C | © localhost:8080/myServlet2 


这 是 : MyServlet2 


图 4-14 在 浏览 器 中 输入 localhost:8080/myServlet2 的 结果 


4.8.7 创建 类 MyFilter 


创建 类 MyFilter， 代 人 码 如 例 4-33 所 示 。 
【 例 4-33】 创建 类 MyFilter 的 代码 示例 。 


package com.bookcode.servlet; 
import javax.servlet.*; 
import javax.servlet.annotation.WebFilter; 
import java.io.IOException; 
QWebFilter(filterName-"myFilter",urlPatterns-"/*") 
public class MyFilter implements Filter { 
QOverride 
public void init(FilterConfig config) throws ServletException { 
System.out .println(" 过 滤器 初始 化 ") ; } 
QOverride 
public void doFilter(ServletRequest request, ServletResponse response, 
FilterChain chain) throws IOException, ServletException { 
System.out .print1ln(" 执 行 过 滤 操 作 ") ; 
chain.doFilter(request, response);) 
QOverride 
public void destroy() ( 
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System.-out .println(" 过 滤器 销毁 ") ; } 


4.8.8 创建 类 MyServletContextListener 


创建 类 MyServletContextListener, fV 4349] 4-34 所 示 。 
【 例 4-34] 创建 类 MyServletContextListener 的 代码 示例 。 


package com.bookcode.servlet; 
import javax.servlet.ServletContextEvent; 
import javax.servlet.ServletContextListener; 
import javax.servlet.annotation.WebListener; 
QWebListener 
public class MyServletContextListener implements ServletContextListener ( 
QOverride 
public void contextDestroyed(ServletContextEvent argq0) ( 
System.out.println("ServletContex 销毁 ") ; } 
QOverride 
public void contextInitialized(ServletContextEvent arg0) { 
System.out.println("ServletContex 初始 化 ") ; } 


4.8.9 创建 类 MyHttpSessionListener 


创建 类 MyHttpSessionListener， 代 人 码 如 例 4-35 所 示 。 
【 例 4-35] 创建 类 MyHttpSessionListener 的 代码 示例 。 


package com.bookcode.servlet; 
import javax.servlet.annotation.WebListener; 
import javax.servlet.http.HttpSessionEvent; 
import javax.servlet.http.HttpSessionListener; 
QWebListener 
public class MyHttpSessionListener implements HttpSessionListener { 
QOverride 
public void sessionCreated(HttpSessionEvent se) { 
System.out.println("Session 被 创建 ") ; } 
QOverride 
public void sessionDestroyed(HttpSessionEvent se) ( 
System.out.println("ServletContex 初始 化 ") ; } 


—* pp— 


4.8.10 ”运行 程序 3 


运行 程序 后 ,控制 台中 的 输出 结果 如 图 4-15 所 示 。 下 在 浏览 融 中 输入 对 任意 一 个 页 面 
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的 访问 (如 http://localhost:8080/myServlet2)， 控 制 台 中 的 输出 结果 如 图 4-16 所 示 。 


ServletContex4]A& 1. 


UE E VARE 


图 4-15 程序 运行 后 在 控制 台中 的 输出 结果 


执行 过 涛 操作 


图 4-16 在 浏览 器 中 输入 对 任意 一 个 页 面 的 访问 后 在 控制 台中 的 输出 结果 


4.8.11 创建 类 MyInterceptor1 


创建 类 MyIterceptor1， 代 人 码 如 例 4-36 所 示 。 
【 例 4-36] 创建 类 MyInterceptorl 的 代码 示例 。 


package com.bookcode.servlet; 
import org.springframework.web.servlet.HandlerInterceptor; 
import org.springframework.web.servlet.ModelAndView; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
public class MyInterceptorl implements HandlerInterceptor { 
QOverride 
public boolean preHandle (HttpServletRequest request, HttpServletResponse 
response, Object handler) 
throws Exception { 
System.out .println(">>>MyInterceptor1>>>>>>> 在 请 求 处 理 之 前 进行 调用 
(Controller 方法 调用 之 前 ) "); 
return truez// 只 有 返回 true JRA FAIT, BE] false 取消 当前 请 求 
} 
QOverride 
public void postHandle (HttpServletRequest request, HttpServletResponse 
response, Object handler, 
ModelAndView modelAndView) throws Exception { 
System.out .println(">>>MyInterceptor1>>>>>>> 请 求 处 理 之 后 进行 调用 , 但 是 
在 视图 被 泻 染 之 前 (Controller 方法 调用 之 后 ) ") ; 
} 
QOverride 
public void afterCompletion(HttpServletRequest request, HttpServletResponse 
response, Object handler, Exception ex) 
throws Exception { 
System.out .println(">>>MyInterceptor1>>>>>>> 在 整个 请 求 结 束 之 后 被 调用 ， 
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也 就 是 在 DispatcherServlet 演 染 了 对 应 的 视图 之 后 执行 〈 主 要 是 用 于 进行 资源 清理 
NE (3 LO ES 


4.8.12 ”创建 类 MyInterceptor2 


创建 类 MyImterceptor2， 代 人 码 如 例 4-37 所 示 。 
【 例 4-37】 创建 类 MyInterceptor2 的 代码 示例 。 


package com.bookcode.servlet; 
import org.springframework.web.servlet.HandlerInterceptor; 
import org.springframework.web.servlet.ModelAndView; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
public class MyInterceptor2 implements HandlerInterceptor { 
QOverride 
public boolean preHandle (HttpServletRequest request, HttpServletResponse 
response, Object handler) 
throws Exception { 
System.out .println(">>>MyInterceptor2>>>>>>> 在 请 求 处 理 之 前 进行 调用 
(Controller 方法 调用 之 前 ) ") ; 
return true;// 只 有 返回 true 才 会 继续 回 下 执行 ， 返 回 false 取消 当前 请 求 
} 
QOverride 
public void postHandle (HttpServletRequest request, HttpServletResponse 
response, Object handler, 
ModelAndView modelAndView) throws Exception { 
System.out .println(">>>MyInterceptor2>>>>>>> 请 求 处 理 之 后 进行 调用 , 但 是 
在 视图 被 泻 染 之 前 (Controller 方法 调用 之 后 ) ") ; 
} 
QOverride 
public void afterCompletion(HttpServletRequest request, HttpServletResponse 
response, Object handler, Exception ex) 
throws Exception { 
System.out .println(">>>MyInterceptor2>>>>>>> 在 整个 请 求 结束 之 后 被 调用 ， 
也 就 是 在 DispatcherServlet 演 染 了 对 应 的 视图 之 后 执行 〈 主 要 是 用 于 进行 资源 清理 
TIER" 


4.8.43 创建 类 MyWebAppConfigurer 


创建 类 MyWebAppConfigurer, [Vf] 4-38 所 示 。 
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【 例 4-38】 创建 类 MyWebAppConfigurer 的 代码 示例 。 


package com.bookcode.config; 
import com.bookcode.servlet.MyInterceptorl; 
import com.bookcode.servlet.MyInterceptor2; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.web.servlet.config.annotation.InterceptorRegistry; 
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter; 
QConfiguration 
public class MyWebAppConfigurer extends WebMvcConfigurerAdapter { 
QOverride 
public void addInterceptors (InterceptorRegistry registry) ( 
// 多 个 拦截 器 组 成 一 个 拦截 器 链 
//addPathPatterns 用 于 添加 拦截 规则 
//excludePathPatterns 用 户 排除 拦截 
registry.addInterceptor (new MyInterceptorl ()).addPathPatterns ("/**"); 
registry.addInterceptor (new MyInterceptor?2 ()).addPathPatterns ("/**"); 


super.addInterceptors (registry); 


4.8.14 ”运行 程序 4 


运行 程序 后 ， 在 浏览 器 中 输入 对 任意 一 个 页 面 的 访问 (如 http://localhost:8080/index)， 


控制 全 中 的 结 末 如 图 4-17 Bras. 


vl 


un Ae Ww N 


>>>MyInterceptor1>>>>>》> 在 请 求 处 理 之 前 进行 调用 (Controller 方 法 调用 之 前 》 
>>>MyInterceptor2>>>>>》> 在 请 求 处 理 之 前 进行 调用 (Controller 方 法 调用 之 前 》 
>>>MyInterceptor2>>>>>>> 请 求 处 理 之 后 进行 调用 ,但 是 在 视图 被 演 染 之 前 (Controller 方 法 调用 之 后 ) 


>>>MyInterceptorl1>>》>>》》 请 求 处 理 之 后 进行 调用 ， 但 是 在 视图 被 演 梁 之 前 “Controller 方 法 调用 之 后 ) 
>>>MyInterceptor2>>>>>》? 在 稿 个 请 求 结 束 之 后 被 调用 ， 也 就 是 在 DispatcherServlet 演 染 了 对 应 的 视图 之 后 执行 (主要 是 用 于 进行 资源 洁 理 工作 ) 
>>>MyInterceptor1>>>>>》?》 在 整个 请 求 结束 之 后 被 调用 ， 也 就 是 在 DispatcherServlet 演 染 了 对 应 的 视图 之 后 执行 (主要 是 用 于 进行 资源 洁 理 工作 》 


图 4-17 在 浏览 器 中 输入 对 任意 一 个 页 和 面 的 访问 后 在 控制 台中 的 结果 


E 4 


KE2S 
向 答题 
1. R Thymeleaf 的 基础 语法 与 用 法 。 


， 简 述 对 Freemarker 的 理解 。 

， 简 述 对 Ajax 的 理解 。 

， 简 述 对 RESTful 风格 的 理解 。 
， 简 述 对 Bootstrap 的 理解 。 
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6. HIRIT jQuery 的 理解 。 

7. 简 述 过 滤器 、 监 听 器 和 拦截 器 的 不 同 之 处 。 

实现 基于 Thymeleaf 的 动态 Web 页 面 。 

实现 基于 Freemarker 的 Web V Hl. 

实现 对 Ajax 的 应 用 。 

实现 RESTful 风格 的 Web 应 用 。 

实现 带 Bootstrap 和 jQuery 的 Web 应 用 。 

实现 使 用 了 Servlet、 过 滤器 、 监 听 器 和 拦截 器 的 Web 应 用 。 


— A 


ON Un 上 mm N — 


ds 5 5k 
— Spring Boot 的 数据 库 访问 


本 章 结合 实例 介绍 如 何 使 用 JDBC 访问 H2 数据 库 、 如 何 使 用 Spring Data JPA 访问 H2 
数据 库 、 如 何 使 用 Spring Data JPA 和 了 RESTful 访问 H2 数据 库 、 如 何 使 用 Spring Data JPA 访 
问 MySQL 数据 库 、 如 何 访问 MongoDB 数据 库 、 如 何 访问 Neo4j 数据 库 和 访问 数据 库 完整 
示例 。 

MongoDB 数据 库 、Neo4 数据 库 和 第 9 章 将 要 介绍 的 Redis 数据 库 都 属于 NoSQL Not 
Only SQL) 类 型 数据 库 ，NoSQL 泛 指 非 关 系 型 的 数据 库 。 随 大 互联 网 Web 2.0 网 站 (特别 
是 超大 规模 和 高 并 发 的 SNS 类 型 Web 2.0 纯 动 态 网 站 ) 的 兴起 ， 传 统 的 关系 数据 库 暴 露 了 
很 多 难以 克服 的 问题 。 于 是 ， 非 关系 型 数据 库 得 到 了 迅速 的 发 展 。 

对 于 NoSQL 并 没有 一 个 明确 的 范围 和 定义 ， 但 是 它们 有 一 些 相似 特征 。 

(1) 不 需要 事先 定义 数据 模式 和 预定 义 表 结构 。 

(2) NoSQL 往往 将 数据 划分 后 存储 在 dda 

(3) 可 以 在 系统 运行 的 时 候 ， 动 态 增 加 或 者 删除 结 点 。 不 需要 停机 维护 ， 数 据 可 以 目 
动迁 移 。 

(4) NoSQL 中 的 复制 ， 往 往 是 基于 日 志 的 异步 复制 。 这 样 ， 数 据 束 可 以 尽快 地 写 入 到 
一 个 结 点 ， 而 不 会 被 网 络 传输 引起 迟延 。 其 缺点 是 并 不 能 总 是 保证 数据 一 致 性 ， 出 现 故障 
时 可 能 会 丢失 少量 的 数据 。 

(5) 相对 于 事务 严格 的 ACID 特性 ，NoSQL 数据 库 保 证 的 是 BASE 特性 〈 最 终 一 致 性 
和 软 事务 )。 

NoSQL 数据 库 比 较 适 用 于 数据 模型 比较 向 单 、 需 要 更 强 灵 活性 、 对 数据 库 性 能 要 求 较 
高 、 不 需要 高 度 的 数据 一 致 性 等 环境 。NoSQL 数据 库 并 没有 一 个 统一 的 架构 , 两 种 NoSQL 
数据 库 之 间 的 不 同 远 远 超过 两 种 关系 型 数据 库 的 不 同 。 
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5.1 使 用 JDBC 访问 H2 数据 库 


本 市 介绍 如 何 使 用 Spring 的 JdbcTemplate 关 来 构建 一 个 应 用 程序 访问 存储 在 关系 型 数 
HE KEH H2 数据 库 ) 中 的 数据 。 


ndi. 


5.1.1 添加 依赖 


因为 使 用 JDBC 访问 H2 数据 库 , 所 以 需要 增加 对 JDBC 和 H2 的 依赖 。 
因为 要 通过 浏览 堪 来 访问 H2 数据 库 的 控制 台 ， 所 以 需要 有 Web Kiho E 
^b. ft pom.xml 文件 中 ， 在 <dependencles> 和 </dependencies> 之 间 添 加 JDBC、H2 和 Web 
依赖 ， 代 码 如 例 5-1 所 示 。 

【 例 S-1】 添加 JDBC、H2 和 Web 依赖 的 代码 示例 。 


«dependency» 


视频 讲解 


«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-jdbc«/artifactId» 

«/dependency» 

«dependency» 

«groupId»com.h2database«/groupld» 
«artifactId»h2«/artifactId» 

«/dependency» 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 

</dependency> 


5.1.2 ”创建 类 Customer 


在 包 com.bookcode.entity 中 创建 类 Customer, Cf] 5-2 所 示 。 
【 例 S-2】 创建 类 Customer 的 代码 示例 。 


package com.bookcode.entity; 
public class Customer { 
private long id; 
private String firstName; 
private String lastName; 
public long getId() { 
return id; 
} 
public void setId(long id) ( 
this.id - id; 
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public String getFirstName() { 
return firstName; 
} 
public void setFirstName(String firstName) ( 
多 this.firstName = firstName; 
} 
public String getLastName() { 
return lastName; 


} 


public void setLastName(String lastName) ( 
this.lastName - lastName; 
} 
public Customer(long id, String firstName, String lastName) { 
this.id - id; 
this.firstName - firstName; 
this.lastName - lastName; 


) 
QOverride 
public String toString() ( 
return String.format ("Customer[id-$d, firstName-'$s', lastName-'$2s']", 


id, firstName, lastName); 


5.1.3 ”修改 入 口 类 


修改 入 口 类 ， 代 人 码 如 例 5-3 所 示 。 
【 例 S-3】 修改 入 口 类 的 代码 示例 。 


package com.bookcode; 

import com.bookcode.entity.Customer; 

import org.slf4j.Logger; 

import org.slf4j.LoggerFactory; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.CommandLineRunner; 

import org.springframework.boot.SpringApplication; 

import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.jdbc.core.JdbcTemplate; 

import java.util.Arrays; 

import java.util.List; 

import java.util.stream.Collectors; 


QGSpringBootApplication 
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public class DemoApplication implements CommandLineRunnert 


private static final Logger log - LoggerFactory.getLogger (DemoApplication.class); 


public static void main(String[] args) ( 


SpringApplication.run(DemoApplication.class, args); ) 
QGAutowired / /ikfifeAutowired 完成 自动 装配 的 工作 
JdbcTemplate jdbcTemplate; // 对 数据 库 的 所 有 操作 将 要 借助 于 JdbcTemplate 
QOverride 
public void run (String... strings) throws Exception { 
log.info("Creating tables");// 日 志 信息 输出 到 控制 台 
// 创 建 表 customers 


jdbcTemplate.execute("DROP TABLE customers IF EXISTS"); 
jdbcTemplate.execute("CREATE TABLE customers(" 十 
"id SERIAL, first name VARCHAR(255), last name VARCHAR (255))"); 
// 将 整个 数组 的 数组 拆 分 成 £irstName. lastName 的 数组 
List«Object[]» splitUpNames = Arrays.asList ("John Woo", "Jeff Dean", 
"JO0SH Bloch". 
"Josh Long").stream() 
.map(name -» name.split(" ")) 
.Collecti(Collectors.toListt)); 
// 使 用 Java 8 流 以 日 志 信息 形式 输出 每 个 元 组 的 列表 到 控制 台 
splitUpNames.forEach(name -> log.info(String.format("Inserting customer 
EBEDFPI TOP 435 435" 
name[0], name[1]))); 
// 使 用 JdbcTemplate 批 处 理 更 新 数据 
jdbcTemplate.batchUpdate("INSERT INTO customers(first name, last name) 
VALUES (?,2)", splitUpNames); 
log.info("Querying for customer records where first name = 'Josh':"); 
// A4] first name X 'Josh' Hj customer 信息 (id, first name, last name) 
jdbcTemplate.query( 
"SELECT id, first name, last name FROM customers WHERE first name = ?", new 
Object[] ( "Josh" ], 
(rs, rowNum) -> new Customer(rs.getLong("id"), rs.getString 
("first name"), rs.getString("last name") ) 


).forEach(customer -> log.info(customer.toString())); 


5.1.4 ”修改 配置 文件 application.properties 


为 了 更 好 地 观察 对 H2 的 访问 情况 ， 通 过 修改 配置 文件 application.properties 使 H2 2X 
据 库 的 控制 台 可 用 ， 代 人 码 如 例 5-4 rn. 
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【 例 S-4】 修改 配置 文件 application.properties 的 代码 示例 。 
# 为 了 更 好 地 观察 对 H2 的 访问 情况 ， 设 置 使 H2 控制 台 可 用 


spring.h2.console.enabled-true 


5.1.5 ”运行 程序 


运行 程序 ， 数 据 库 处 理 信息 在 控制 台中 输出 ， 结 果 如 图 5-1 所 示 。 


o. s. b. w. enbedded. tomcat. TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path '' 
c. b. SpringboctHelloworldsApplication : Started SpringbootHelloworldsApplication in 3.04 seconds (JVM running for 4. 506) 


joctHellc worldsApplic ation : Creating tables 
n. zaxxer. hikari.HikariDataSource : I ariboor-i — Starting... 


ika ITCÉ : HikariPool-1 - Start completed. 


springbooctHelloworldsApI 
ingbootHelloworldsApplicatio C Inserting customer record for Jeff Dean 

SpringboctHelloworldsApplication F Inserting customer record for Josh Bloch 
ingbootHelloworldsApplicatio X Inserting customer record for Josh Long 

springboctHelloworldsApplication : Querying for customer records where first name = 'Josh': 
ingbootHelloworldsApplicatio : Customer[id-3, firstName-'Josh', lastName-' Bloch’ ] 


SpringboctHelloworldsApplication : Customer[id-4, firstName-'Josh', lastName?’ Long’ ] 


c. C. [Tomcat]. [localhost]. [/] : Initializing Spring FrameworkServlet 'dispatcherServlet' 


: FrameworkServlet 'dispatcherServlet': initialization started 


: FrameworkServlet 'dispatcherServlet': initialization completed in 33 ms 
5-1 数据 库 处 理 信 息 在 控制 台中 的 输出 结果 


为 了 更 好 地 观察 对 数据 库 的 访问 情况 ， 可 以 通过 在 浏览 堪 中 输入 localhost:8080/h2- 
console 来 访问 H2 数据 库 的 控制 台 。H2 控制 台 局 动 界 面 如 图 5-2 所 示 。 单 击 “ 连 接 ” 按 
钮 , 可 以 看 到 H2 数据 库 信息 , 如 图 5-3 所 示 。 图 5-3 还 显示 了 对 表 customers 执行 SELECT 
* FROM CUSTOMERS 操作 后 显示 customers 全 体 记 录 的 情况 ， 这 和 图 5-1 中 输出 信息 


Fo 


ye H2 控制 台 x WV 
€ G | © localhost:8080/h2-console/login.jsp?jsessionid- 7b3d05f97580ecc1 1b95c934046b27a1 


中 文 (简体 ) | 配置 工具 帮助 


保存 的 连接 设置 : Generic H2 (Embedded) v 
连接 设置 名 称 : Generic H2 (Embedded) 


驱动 类 : org.h2.Driver 
JDBC URL: jdbc:h2:mem:testdb 


用 户 名 : 
密码 : 


5-2 HO2 控制 台 局 动 界 面 
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C 


/ gi H2 控制 台 x V 
€ a | © localhost:8080/h2-console/login.do?jsessionid- 7b3d05f97580ecc1 1b95c934046b27a1 


b | f| Bang ^0 "o | 最 大 行 数 :| 1000 v| Q Q W | * | 自动 完成 关闭" |Auto select [On v) © 


(J jdbc:h2:mem:testdb 执行 | Run Selected | | 自动 完成 | | 清除 | SOL 语句 : 
日 国 CUSTOMERS 
0 1D 
目 FIRST_NAME 
目 LAST_NAME 
| 色素 引 
© INFORMATION SCHEMA 
iis FRR) 
田 MW RP 
(1) H2 1.4.197 (2018-03-18) 


ELECT * FROM CUSTOMERS, 
ID |FIRST NAME |LAST NAME 
Woo 


Dean 
Bloch 


Long o | 


图 $-3 H2 数据 库 信 息 


5.2 ”使 用 Spring Data JPA 访问 H2 数据 库 


JPA 是 Java 持久 层 API (Java Persistence API) 的 简称 。JPA 是 JCP 组 
织 发 布 的 Java EE 标准 之 一 , 任何 声称 符合 JPA 标准 的 框架 都 遵循 同样 的 HURVUM 
架构 ， 提 供 相 同 的 访问 API。 这 保证 了 基于 JPA 开发 的 企业 应 用 能 够 很 容易 在 不 同 的 JPA 
框架 下 运行 。 

引入 新 的 JPA 规范 有 两 方面 的 原因 : 一 方面 ， 是 为 了 简化 现 有 Java EE 和 Java SE JV 
用 开发 工作 ; 另 一 方面 ， 是 为 了 整合 对 象 关系 映射 CORMO 技术 。JPA 框架 中 文 持 大 数据 
集 、 事 务 、 并 发 等 容器 级 事务 ， 这 使 得 JPA 超越 了 简单 持久 化 框架 的 局 限 ， 在 企业 应 用 中 
发 挥 更 大 的 作用 。JPA 的 一 个 主要 目标 就 是 提供 更 加 人 简单 的 编程 模型 。 在 JPA 框架 下 创建 
实体 很 俏 单 ， 只 需要 使 用 @Entity 注解 进行 标注 ; JPA 的 框架 和 接口 也 非常 人 简单， 开发 者 可 
以 很 容易 地 掌握 。JPA 的 设计 是 基于 非 侵 入 式 原 则 的 ， 因 此 可 以 很 容易 地 和 其 他 框架 或 者 

JPA 是 一 套 标准 、 规 范 ， 不 是 产品 ，Hiberate、TopLink、JDO、Spring Data JPA 是 具 
体 的 产品 。 为 了 说 明 如 何 使 用 Spring Data JPA 访问 数据 库 ， 本 节 介 绍 使 用 Spring Data JPA 
来 访问 H2 数据 库 。 


5.2.1 ”添加 依赖 


首先 ， 在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 则 添加 Data JPA 和 H2, 
Web 依赖 ， 代 码 如 例 5-5 所 示 。 

【 例 S-$】 添加 Data JPA 和 H2, Web 依赖 的 代码 示例 。 

«dependency» 


«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-data-jpa«/artifactId» 
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</dependency> 

<dependency> 
<groupId>com.h2database</groupId> 
<artifactId>h2</artifactId> 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 

«/dependency» 


5.22 ”创建 类 User 


在 包 com.bookcode.entity 中 创建 类 User, RE] 5-6 所 示 。 
【 例 S-6】 创建 类 User 的 代码 示例 。 


package com.bookcode.entity; 

import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 


@Entity // 注 解 aEntity 说 明 是 数据 实体 类 
public class User { 
QId // 注 解 eId 指明 将 属性 1a 映射 为 数据 库 的 主键 


QGGeneratedValue (strategqy=GenerationType.IDENTITY) // 采 用 目 增 策略 增加 id fH 
private Long id; 
private String firstName; 
private String lastName; 
protected User() {} 
public User(String firstName, String lastName) { 
this.firstName - firstName; 
this.lastName - lastName; 
} 
QOverride 
publie String toString() 4 
return String.format( 
"User[id-$d, firstName-'$s', lastName-'$s']", 
id, firstName, lastName); 


5.2.3 创建 接口 UserRepository 


在 包 com.bookcode.dao 中 创建 接口 UserRepository, 代码 如 例 5-7 所 示 。UserRepository 


接口 扩展 了 JpaRepository 接口 ，JpaRepository 封装 了 对 数据 库 的 访问 方法 ， 其 泛 型 参数 依 
次 为 实体 类 名 和 实体 中 主键 各 的 类 型 。 
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【 例 S-7】 创建 接口 UserRepository 的 代码 示例 。 


package com.bookcode.dao; 

import com.bookcode.entity.User; 

import org.springframework.data.jpa.repository.JpaRepository; 
public interface UserRepository extends JpaRepository«User,Long» { 
) 


5.2.4 ”修改 人 口 炎 


修改 入 口 类 ， 代 人 码 如 例 5-8 所 示 。 
【 例 $-8】 修改 入 口 类 的 代码 示 例 。 


package com.bookcode; 
import com.bookcode.dao.UserRepository; 
import com.bookcode.entity.User; 
import org.slf4j.Logger; 
import org.slf4j.LoggerFactory; 
import org.springframework.boot.CommandLineRunner; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.context.annotation.Bean; 
QGSpringBootApplication 
public class DemoApplication { 
private static final Logger log = LoggerFactory.getLogger (DemoApplication.class); 
public static void main(String[] args) ( 
SpringApplication.run(DemoApplication.class, args); } 
@Bean 
public CommandLineRunner demo(UserRepository repository) { 
return (args) > I 
// 存 储 5 条 用 户 记 录 到 数据 库 
repository.save(new User("Jack", "Bauer")); 
repository.save(new User("Chloe", "O'Brian")); 
repository.save(new User("Kim", "Bauer")); 
repository.save(new User("David", "Palmer")); 
repository.save(new User("Michelle", "Dessler")); 
// 将 所 有 user 信息 以 日 志 形 式 输出 到 控制 台 
log.info("Users found with findAll():"); 
二 一 "ET 
for (Object user : repository.findAl11()) ( 
log.info(user.toString()):; } 
/ /获取 id-1 的 user 信息 ， 并 以 日 志 形 式 在 控制 台 输 出 
repository.findById (1L) 
.lfPresent (User -> ( 
log.info("User found with findById(1L):"); 
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log.info("-------------------------------- "); 
log.info(User.toString()); 
)); 


5.2.5 ”修改 配置 文件 application.properties 


为 了 更 好 地 观察 对 H2 数据 库 的 访问 情况 ， 通 过 修改 配置 文件 application.properties 使 
H2 数据 库 的 控制 台 可 用 ， 代 码 如 例 5-4 所 示 。 


52.6 ”运行 程序 


运行 程序 ， 数 据 库 处 理 信息 在 控制 台中 的 输出 结果 如 图 5-4 所 示 。 在 H2 数据 库 的 控 
制 台 中 看 到 的 H2 数据 库 信 息 如 图 5-5 Bron 


: Tomcat started on port(s): 8080 (http) with context path '' 
: Started SpringbootHelloworldsApplication in 6.63 seconds (JVM running for 8.497) 
: Users found with findAll(): 


: HHH000397: Using ASTQueryTranslatorFactory 

: User[id-1, firstName-'Jack', lastName-'Bauer'] 

; Userlid=2, firstName-'Chloe', lastName-'' Brian! ] 

: User[id-3, firstName-' Kim , lastName-' Bauer'] 

: User[id-4, firstName-'David', lastName-'Palmer'] 

: Userlid-5, firstName-'Michelle', lastName-'Dessler' | 
: User found with findById(lL): 


: User[id-1l, firstName-' Jack , lastName-' Bauer’ ] 


/ gi H2 控制 台 x WB 


一 G | © localhost:8080/h2-console/login.do?jsessionid -e5544 


N| $| aam 70 名 | 最 大 行 数 [1000 v| Q Q WM | 
(] jdbc:h2:mem:testdb 

由 Ej USER SELECT * FROM USER| 

(7) INFORMATION SCHEMA 
田 器 ; 序列 

田 W Rr 

(3) H2 1.4.197 (2018-03-18) 


SELECT * FROM USER; 


ID | FIRST NAME | LAST NAME 
1 | 


Jack Bauer 


|2 |Chloe O'Brian 

3 Kim Bauer 

4 David Palmer 

15 [Michelle [Dessler | 
(5 行 , 8 ms) 


图 5-5 在 H2 数据 库 的 控制 台中 看 到 的 H2 数据 库 信息 
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5257 程序 扩展 


在 包 com.bookcode.dao 中 创建 接口 UserCrudRepository ， 代 码 如 例 5-9 所 示 。 
UserCrudRepository 接口 继承 了 CrudRepository 接口 ， 并 增加 了 一 个 访问 数据 库 的 方法 。 


【 例 S-9】 创建 接口 UserCrudRepository 的 代码 示例 。 


package com.bookcode.dao; 


import com.bookcode.entity.User; 


import org.springframework.data.repository.CrudRepository; 


import java.util.List; 


public interface UserCrudRepository extends CrudRepository«User, Long» { 


List«User» findByLastName (String lastName); 


修改 入 口 类 ， 代 码 如 例 5-10 所 示 。 


【 例 5-10] 


修改 入 口 关 的 代码 示例 。 


package com.bookcode; 


import com.bookcode.entity.User; 


import com.bookcode.dao.UserCrudRepository; 


import org.slf4j.Logger; 


import org.slf4j.LoggerFactory; 


import org.springframework.boot.CommandLineRunner; 


import org.springframework.boot.SpringApplication; 


import org.springframework.boot.autoconfigure.SpringBootApplication; 


import org.springframework.context.annotation.Bean; 


QGSpringBootApplication 


public class DemoApplication { 


private static final Logger log = LoggerFactory.getLogger (DemoApplication.class); 


public static void main(String[] args) { 


SpringApplication.run(DemoApplication.class, args); ) 


QBean 


public CommandLineRunner demo(UserCrudRepository repository) ( 


return (args) > I 


repository.save(new User("Jack", "Bauer")); 
repository.save(new User("Chloe", "O'Brian")); 
repository.save(new User("Kim", "Bauer")); 
repository.save(new User("David", "Palmer")); 
repository.save(new User("Michelle", "Dessler")); 
Dodq.:nfro[""). // 在 控制 台中 输出 空 行 
// 碍 找 lastName 为 'Bauer' 的 所 有 user， 并 以 日 志 形 式 输出 到 控制 台 
log.info("Customer found with findByLastName ('Bauer'):"); 


log.info("-------------------------------------------- "); 
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repository.findByLastName ("Bauer").forEach(bauer -> { 
log.info(bauer.toString()); 
)):; 


~ 一 


运行 程序 ， 处 理 数据 库 的 信息 在 控制 台中 的 输出 结 末 如 图 5-6 所 示 。 


: Tomcat started on port (s): 8080 (http) with context path '' 


: Started SpringbootHelloworldsApplication in 5.06 seconds (JVM running for 7.033) 


: Customer found with findByLastName (' Bauer’ ) : 


: HHH000397: Using ASTQueryTranslatorFactory 
: User[id-1, firstName-' Jack , lastName-' Bauer’ ] 


: User[id-3, firstName- Kim , lastName-' Bauer | 


图 5-6 数据库 处 理 信 息 在 控制 台中 的 输出 结果 (lastName 为 Bauer 的 所 有 user 信息 ) 
5.3 ”使 用 Spring Data JPA 和 RESTful 访问 H2 数据 库 


5.3.1 ”添加 依赖 


ft pom.xml 文件 中 <dependencles> 和 </dependencles> 之 间 添 加 Data JPA、 
REST, H2 和 Web 依赖 ， 代 码 如 例 5-11 所 示 。 
【 例 S-11】 添加 Data JPA, REST, H2 和 Web 依赖 的 代码 示例 。 


视频 讲解 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-data-jpa«/artifactId» 

«/dependency» 

«dependency» 
«groupId»org.springframework.data«/groupId» 
«artifactId»spring-data-rest-core«/artifactId» 

«/dependency» 

«dependency» 

«groupId»com.h2database«/groupId» 
«artifactId»h2«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 

«/dependency» 


5.3.2 ”创建 类 Person 


在 包 com.bookcode.entity 中 创建 类 Person, REH] 5-12 所 示 。 
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【 例 S-12】 创建 类 Person 的 代码 示例 。 


package com.bookcode.entity; 
import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 
QEntity 
public class Person { 
QId 
@GeneratedValue (strategy = GenerationType.AUTO) 
private Long id; 
private String firstName; 
private String lastName; 
public String getFirstName() { 
return firstName; 
} 
public void setFirstName(String firstName) { 
this.firstName - firstName; 
} 
public String getLastName() ( 
return lastName; 
} 
public void setLastName (String lastName) { 
this.lastName - lastName; 


5.3.3 ”创建 接口 PersonRepository 


在 包 com.bookcode.dao 中 创建 接口 PersonRepository, 4V 43 lf 5-13 所 示 。 
PersonRepository 接口 继承 了 PagingAndSortingRepository 接口 ， 并 增加 了 一 个 访问 数据 库 
的 方法 。 

【 例 S-13】 创建 接口 PersonRepository 的 代码 示例 。 


package com.bookcode.dao; 

package com.bookcode; 

import java.util.List; 

import org.springframework.data.repository.PagingAndSortingRepository; 
import org.springframework.data.repository.query.Param; 

import org.springframework.data.rest.core.annotation.RepositoryRestResource; 
QGRepositoryRestResource (collectionResourceRel = "people", path = "people") 
// 访 问 路 径 

public interface  PersonRepository extends  PagingAndSortingRepository 
«Persuan, bong» | 


List«Person» findByLastName (8Param("name") String name); 
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5.3.4 ”修改 配置 文件 application.properties 


为 了 更 好 地 观察 对 H2 数据 库 的 访问 情况 ， 通 过 修改 配置 文件 application.properties 使 
H2 数据 库 控 制 台 可 用 ， 代 码 如 例 5-4 所 示 。 


5.3.5 ”启动 程序 并 进行 REST 服务 测试 


测试 用 到 的 工具 是 Postman, Postman 是 一 个 文 持 REST 的 客户 问 ， 可 以 用 它 来 测试 资 
源 。 它 可 以 被 安装 成 Chrome 插件 ,或 者 安装 成 独立 应 用 程序 .本 书 采 用 后 一 种 方式 ,Postman 
安装 过 程 比较 人 简单， 本 书 不 做 介绍 。 

局 动 程 序 后 可 以 利用 Postman 进行 REST 服务 测试 。 当 需要 奏 询 所 有 people 时 ， 先 在 
Postman 的 URL 处 输入 http://localhost:8080/people, 再 选择 GET 方法 ,结果 如 图 5-7 所 示 。 
当 需 要 增加 一 条 记录 《以 增加 “ 王 三 ” 的 信息 为 例 ) 时 ， 在 Postman 的 URL 处 输入 
http://localhost:8080/people， 并 选择 POST 方法 和 JOSN(application/json) 格 式 ， 骨 以 JSON 
格式 输入 “ 王 三 ” 的 firstName CC E) FI lastName (“=”), 结果 如 图 5-8 FTIR o 搜索 lastName 
为 “三 ”的 people 信息 时 ， 先 在 Postman 的 URL 处 输入 http://localhost:8080/people/search/ 
findByLastName?name- =, H4% GET 方法 ， 结 果 如 图 5-9 所 示 。 对 H2 数据 库 处 理 的 结 
TE H2 数据 库 控制 台中 的 输出 如 图 5-10 Prog. 


Ø Postman 
File Edit View Help 


New v ae My Workspace v 4, Invite 


" embedded": ( 
"people": [ 
Doc a f 
» Bà ostman Echo l 
37 requests "firstName": "Sk", 
"lastName": ”一 ” 


"self": ( 
"href": : //localhost:8080/people/1" 
) 
"person": ( 

"href": "http: //localhost:80898/people/1" 
3 
h 


"firstName": [LI w 
"lastName": "二 让" 
" links": ( 

"self i 


"href": "http: //localhost:8080/people/2" 


) 
"person": ( 
"href": "http://localhost:80880/people/2" 
} 
Y 
2 


图 5-7 在 Postman 的 URL 处 输入 http://localhost:8080/people 
查询 全 体 people 信息 的 结果 


Collections 


wl 


» 
romi inet 
< reguesis 


Postman Echo 


37 requests 
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se My Workspace v 4, Invite 


http-//localhosc8080/, € + +s 


http://localhost:3080/people 


form-data x-www-form-urlencoded ® raw binary 


K firstName":" T ","lastName":"—"] 


"firstName": "I 

"lastName": "—" 

" links": ( 
"self": ( 


"href": "http: //1localhost:8080/people/6" 


"firstName": "gk", 
= 


"lastName": 


" links": { 
"self": { 


Fs 


"href": "http: //localhost:80809/people/1" 


"person": 1{ 


h 


"href": "http: //localhost:8089/people/1" 


"firstName": 

"lastName": " 

" links": { 
"Self": 1 


Fal 


"href": "http: //localhost:88808/people/6" 


"person": 1 


} 


"href": "http: //localhost:8080/people/6" 


5-9 ”搜索 lastName 为 “三 ”的 结果 
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E- | © localhost:8080/h2-console/login.do?jsession 


二 | $ | oean 70 "o | 最 大 行 数 :|1000 v| OQ Q m 


n A jdbc:h2:mem:testdb 执行 | Run Selected 自动 完成 | 清除 
i Ed PERSON SELECT * FROM PERSON| 

C INFORMATION SCHEMA 

E] £23 序列 

E uw 用 户 

(3) H2 1.4.197 (2018-03-18) 


SELECT * FROM PERSON; 
ID |FIRST NAME 


图 5-10 X} H2 数据 库 处 理 的 结果 在 H2 数据 库 控制 台中 的 输出 


5.4 使 用 Spring Data JPA 访问 MySQL 数据 库 


本 节 介 绍 如 何 使 用 Spring Data JPA 访问 MySQL 数据 库 。 首 先 ， 需 要 安 
$e MySQL 数据 库 ， 在 安装 MySQL 数据 库 时 保留 访问 端口 (3306)、 用 户 
名 、 密 码 信息 ， 在 访问 数据 库 时 要 用 到 这 些 信息 。MySQL 数据 库 安 装 过 程 比较 简单 ， 本 
书 不 做 介绍 。 


视频 讲解 


5.4.4. 添加 依赖 


首先 ， 在 pom.xml 文件 中 <dependencles> 和 </dependencles> 之 间 添 加 Data. JPA 依赖 和 
MySQL 张 动 依赖 ， 人 代码 如 例 5-14 所 示 。 
【 例 S-14】 添加 Data JPA 依赖 和 MySQL 驱动 依赖 的 代码 示例 。 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-data-jpa«/artifactId» 
«/dependency» 
<!-- 使 用 MySseL 的 Connector/J 驱动 --> 
«dependency» 
«groupId»mysql«/groupId» 
«artifactId»mysql-connector-java«/artifactId» 


</dependency> 
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5.4.2 ”创建 类 User 和 接口 UserRepository 


在 包 com.bookcode.entity 中 创建 类 User， 代 人 码 如 例 5-15 所 示 。 在 包 com.bookcode.dao 
中 创建 接口 UserRepository， 代 人 码 如 例 5-7 所 示 。 
【 例 S-1S】 创建 类 User 的 代码 示例 。 


< < 


package com.bookcode.entity; 


import javax.persistence.*; 


QGEntity 
QTable(name-"user") / /增加 此 行 语句 来 指定 所 映射 的 表 名 
public class User { 

@Id 


QGGeneratedValue (strategy-GenerationType.IDENTITY) 
private Long id; 
private String firstName; 
private String lastName; 
protected User() {} 
public User(String firstName, String lastName) { 
this.firstName - firstName; 
this.lastName - lastName; 
} 
QOverride 
public String toString() d 
return String.format( 
"User[id-$d, firstName-'$s', lastName-'$s']", 


id, firstName, lastName); 


5.4.3 ”修改 配置 文件 和 和 入口 类 


在 配置 文件 application.properties 中 增加 MySQL 数据 源 配 置信 息 , 代 码 如 例 5-16 所 示 。 
【 例 S-16】 增加 MySQL 数据 源 配置 信息 的 代码 示例 。 


tMySQL 数据 源 基本 配置 信息 

# 指 定数 据 库 
spring.datasource.url-jdbc:mysql://localhost:3306/mytest 
# 驱 动 程序 
spring.datasource.driver-class-name-com.mysql.jdbc.Driver 
spring.datasource.username-root 
spring.datasource.password-sa 

# 更 新 时 修改 数据 库 

spring.jpa.hibernate.ddl-auto-update 
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修改 入 口 类 ， 代 人 码 如 例 5-8 所 示 。 
5.4.4 ”运行 程序 


运行 程序 后 ， 控 制 台 的 输出 信息 与 图 5-6 相同 。 同 时 ，MySQL 的 数据 库 mytest 中 日 
JÆ I K user， 并 且 插 入 了 5$ 条 user 记录 ， 对 MySQL 数据 库 的 处 理 结果 在 工具 Navicat 
for MySQL 中 的 输出 情况 如 图 5-11 所 示 。 工 具 Navicat for MySQL 的 安装 过 程 比 较 简 单 ， 
本 书 不 做 介绍 。 


4M Navicat for MySQL 


v A? mysql 
ii blog nt 
fij cookbook ipis " s EU — "M 
nn Pltsudent | 四 号 入 向 S 本 导出 向 Y owes | | 
Ñi demo test Euser id 
fi depot — 
图 informatio | 
图 mybatis 2 Chloe O'Brian 
(i) mydata 3 Kim Bauer 
Ñi mydataba: 4 David Palmer 
图 mysql 5 Michelle Dessler 

v Bl mytest 


first name last name 


Jac Bauer 


5-1] 对 MySQL 的 处 理 结果 在 工具 Navicat for MySQL 中 的 输出 


5.4.5 ”程序 扩展 


在 包 com.bookcode.controller 中 创建 类 UserController， 其 代码 如 例 5-17 所 示 。 在 包 
com.bookcode.dao 中 增加 接口 UserCrudRepository， 其 代码 如 例 5-9 所 示 。 
【 例 S-17】 创建 类 UserController 的 代码 示例 。 


package com.bookcode.controller; 
import com.bookcode.dao.UserCrudRepository; 
import com.bookcode.entity.User; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.*; 
import java.util.List; 
GController / /控制 器 
@RequestMapping (path="/demo") ”//UserController 类 中 地 址 是 相对 地 址 ， 在 /demo 后 添加 
public class UserController { 
QAutowired 
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private UserCrudRepository userCrudRepository; 
QGGetMapping (path-"/add") // 相 对 地 址 ， 相 当 于 /demo/add 
QResponseBody / /eResponseBody 表明 返回 是 字符 串 而 不 是 视图 名 
public String addNewUser (8RequestParam String firstname , QRequestParam 
String lastname) { 
/ / eRequestParam 表示 传 入 User 构造 器 中 的 参数 
User user = new User (firstname, lastname); 
userCrudRepository.save (user); 
return "Saved"; 


} 
@GetMapping (path="/finduser/{lastname}") // 根 据 Lastname 查找 返回 user 信息 


@ResponseBody 
//@PathVariable 表示 参数 lastname 
public String finduser (@PathVariable ("lastname") String lastname) { 
List«User» userList = userCrudRepository.findByLastName (lastname) ; 
String users =" "; 
for (User user:userList) {users += user.toString() +" 


return users; 


运行 程序 后 ， 为 了 增加 firstname 7j 1 H. lastname 为 si 的 user, EXI Was PHA 
localhost:8080/demo/add?firstname-li&lastname-si, #4 R tp] 5-12 所 示 ; 数据 库 的 user 表 
中 新 增 记录 在 工具 Navicat for MySQL 中 的 结果 如 图 5-13 所 示 。 为 了 查找 lastname 为 Bauer 
的 所 有 user 信息 ， 需 要 在 浏览 器 中 输入 localhost:8080/demo/finduser/Bauer， 结 果 如 图 5-14 
所 示 。 


/ gi localhost8080/demo/s x \ W 


< é | © localhost:8080/demo/add?firstname-li&lastname-si 


图 5-12 增加 user (firstname 为 li H. lastname 为 si) 结果 


F user Gmytest (mysql) - 表 
文件 Sut EB 窗口 帮助 
P 导入 向 导 Esse Y 自选 向 导 


id first name last name 
2 "LE Bauer 
2 Chloe O'Brian 
3 Kim Bauer 
4 David Palmer 
5 Michelle Dessler 
6 z s 
7 li si 


图 5-13 user 表 新 增 记 录 在 工具 Navicat for MySQL 中 的 结果 
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| g localhost:8080/demo// X ^V 


€ G | © localhost:8080/demo/finduser/Bauer 


User[id- 1, firstName-'Jack', lastName-'Bauer'] User[id=3, firstName-'Kim', lastName- 'Bauer'] 


图 5-14 在 浏览 器 中 输入 localhost:8080/demo/finduser/Bauer 
(查找 lastname 为 Bauer 的 user) 的 结果 


5.5 访问 MongoDB 数据 库 


在 当前 流行 的 NoSQL 数据 库 中 ，MongoDB 数据 库 是 用 得 比较 多 的 数据 uter 
库 。MongoDB 数据 库 是 基于 文档 的 存储 型 数据 库 。MongoDB 数据 库 使 用 面 视频 讲解 
问 对 象 的 思想 ， 每 条 数据 记录 都 是 文档 的 对 象 。Spring 对 MongoDB 数据 库 
的 支持 主要 是 通过 Spring Data MongoDB 来 实现 的 。 由 于 Spring Boot 对 MongoDB 数据 库 有 
专门 的 文 持 ，Spring Boot 在 访问 MongoDB 数据 库 时 不 需要 进行 配置 。 使 用 MongoDB 数据 
库 前 需要 先 安 装 MongoDB 数据 库 ，MongoDB 数据 库 有 Window, Linux 等 系统 的 安装 包 ， 
安装 过 程 比较 简单 ， 本 书 不 做 介绍 。 


5.5.1. 添加 依赖 


在 pom.xml 文件 中 <dependencles> 和 </dependencies> 之 间 添 加 MongoDB, Web 等 依赖 ， 
代码 如 例 5-18 所 示 。 
【 例 S-18】 添加 MongoDB, Web 等 依赖 的 代码 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-data-mongodb«/artifactId» 

«/dependency» 

«dependency» 

«groupId»javax.persistence«/groupId» 
«artifactId»persistence-api«/artifactId» 
«version»1.0«/version» 

«/dependency» 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 

«/dependency» 


5.5.2 ”创建 类 Person 


在 包 com.bookcode.entity 中 创建 类 Person， 代 人 码 如 例 5-19 所 示 。 
【 例 S-19】 创建 类 Person 的 代码 示例 。 


package com.bookcode.entity; 
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import javax.persistence.Id; 


public class Person { 


@Id 

public 
public 
public 
public 
public 


Strsng db 

String firstName; 
String lastName; 
Person() {} 


Person (String firstName, String lastName) { 


Enis FirstName — d$irsbENAame-^ 


this.lastName = lastName; 


} 


QOverride 


public 


String toString() I 


return String.format( 


} 


"Person[id-$s, firstName-'$s', lastName-'$s']", 


id, firstName, lastName); 


public String getFirstName() { 


return firstName; 


} 


public void setFirstName(String firstName) ( 


this.firstName - firstName; 


} 


public String getLastName() ( 


return lastName; 


} 


public void setLastName(String lastName) { 


this.lastName = lastName; 


5.5.3 创建 接口 PersonRepository 


在 包 com.bookcode.dao 中 创建 接口 PersonRepository ， 人 代码 如 例 5-20 所 示 。 


PersonRepository 接口 继承 并 扩展 了 MongoRepository 接口 。MongoRepository 封装 了 对 数 


HJE MongoDB 的 访问 方法 ， 其 泛 型 参数 依次 为 实体 类 名 和 实体 中 主键 id 的 类 型 。 
【 例 S-20】 创建 接口 PersonRepository 的 代码 示 例 。 


package com.bookcode.dao; 


import com.bookcode.entity.Person; 


import org.springframework.data.mongodb.repository.MongoRepository; 


import java.util.List; 


public interface PersonRepository extends MongoRepository«Person, String» ( 


public Person findByFirstName (String firstName); 
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public List<Person > findByLastName (String lastName); 


5.5.4 ”修改 入 口 类 


修改 入 口 类 ， 人 代码 如 例 5-21 所 示 。 
【 例 S-21】 修改 入 口 类 的 代码 示例 。 


package com.bookcode; 
import com.bookcode.dao.PersonRepository; 
import com.bookcode.entity.Person; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.CommandLineRunner; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
QGSpringBootApplication 
public class DemoApplication implements CommandLineRunner f 
QAutowired 
private PersonRepository repository; 
public static void main (String[largs)( 


SpringApplication.run(DemoApplication.class, args); 


QOverride 
public void run (String...args) throws Exception 1 
repository.deleteAll(); // 辅 助 功能 ， 先 删除 已 有 记录 
repository.save(new Person("Alice", "Smith")); // 存 储 Person 信息 
repository.save(new Person("Bob", "Smith")); // 存 储 Person 信息 
// 将 所 有 Person 信息 输出 
System.out.println("Persons found with findAll():"); 
System.out.println("------------------------------- mie 
for (Person person : repository.findAll()) ( 

System.out.println (person); 
} 
System.out.println(); 
/ /1k firstName 为 'Alice' 的 Person， 并 将 其 信息 输出 到 控制 台 
System.out.println("Person found with findByFirstName('Alice'):"); 
System.out.println("-------------------------------- 区 全 
System.out.println(repository.findByFirstName ("Alice")); 
// 找 lastName 为 Smith 的 Person， 并 将 其 信息 输出 到 控制 台 
System.out.println("Persons found with findByLastName('Smith'):"); 
System.out.println("-------------------------------- Ep 
for (Person Person : repository.findByLastName ("Smith")) ( 


System.out.println (Person); 
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5.5.5 ”运行 程序 


先 在 Window 命令 处 理 程序 CMD 中 输入 命令 , 启动 MongoDB 数据 库 , 代码 如 例 5-22 
所 示 。 人 代码 中 路 径 和 MongoDB 数据 库 的 设置 有 关 。 
【 例 5-22] 启动 MongoDB 数据 库 的 代码 示例 。 


mongod --dbpath "D:NMmongodbNdataNdb" 


启动 MongoDB 数据 库 后 ， 运 行程 序 ， 控 制 台 中 的 输出 如 图 5-15 所 示 。 与 此 同时 ， 
MongoDB 数据 库 中 的 数据 库 test 中 自动 生成 了 2 条 记录 ,在 可 视 化 工具 Robo 3T 中 的 显示 
情况 如 图 5-16 所 示 。 可 视 化 工具 Robo 3T 的 安装 过 程 比 较 简 单 ， 本 书 不 做 介绍 。 


Persons found with findAll(): 


Person[id-5b0a2f549513f31e6cb493d3, firstName-'Alice', lastName-' Smith’ ] 
Person[id-5b0a2f549513f31e6cb493d4, firstName-' Bob’, lastName-' Smith’ ] 


Person found with findByFirstName (' Alice’): 


Person[id-5b0a2f549513f31e6cb493d3, firstName-'Alice', lastName-' Smith | 
Persons found with findByLastName (' Smith’): 


Person[id-5b0a2f549513f31e6cb493d3, firstName-'Alice', lastName-' Smith' ] 
Person[id-5b0a2f549513f31e6cb493d4, firstName-'Bob', lastName-' Smith | 


图 5-15 ”控制 台中 的 输出 


$ Robo 3T - 1.2 
File View Options Window Help 
| A 
me 了 - kl » - ^ 
v Mylocalmongodb (2) 
ra System 
> B local S? Mylecalnorgodb | localhost:27017 BE test 
wv I test dD.gevtCollection('person'j.find 
a Collections (1) 国 person 中 0.001 sec. 
bd 图 person 
Y Indexes (1) Kay — 


È welcone X Q+ à. geicollection( perso" x 


id v 加 (1) Objectld(*5b0221549513f31e6cb493d3") (4 fields ) 


》 Functions (0) 


> | j Users 


dd Objectld("5b0a2í549513f31e6cb493d3") 
firstName Alice 

lastName Smith 

cass com.bookcode.domain.Person 
Objectld("*5b0221549513f31e6cb493d4") (4 fields ) 

dd Objectld("5b0a2[549513f31e6cb493d4") 
firstName Bob 


lastName Smith 


€ 
E 


. dass com.bookcode.domain.Person 


图 5-16 MongoDB 数据 库 增 加 2 条 记录 在 可 视 化 工具 Robo 3T 中 的 显示 情况 
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5.5.6 ”程序 扩展 


在 包 com.bookcode.controller 中 创建 类 PersonController， 代 个 如 例 5-23 所 示 。 
i 【 例 5-23] 创建 类 PersonController I] 4&6 37r fl , 


package com.bookcode.controller; 
import com.bookcode.dao.PersonRepository; 
import com.bookcode.entity.Person; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 
import java.util.List; 
QGRestController 
public class PersonController { 
QAutowired 
private PersonRepository personRepository; 
QGRequestMapping ("/save") 
public String save() { 
Person person = new Person("Li","wl1"); 
personRepository.save (person); 
return "Save OK!"; } 
QRequestMapping ("/q1") 
public Person ql(String firstname) ( 
Person person - personRepository.findByFirstName (firstname); 
return personRepository.save (person); } 
GRequestMapping ("/q2") 
public String q2(String lastname) { 
List«Person» listperson - personRepository.findByLastName (lastname); 
String persons =" "; 
for(Person person:listperson) [persons += person + " LE S- 


return persons; } 


保持 入 口 类 不 变 。 

启动 MongoDB 数据 库 后 ， 运 行程 序 。 在 浏览 器 中 输入 localhost:8080/save， 结 果 如 
图 5-17 所 示 。 在 浏览 器 中 输入 localhost:8080/ql?firstname=Alice， 结 果 如 图 5-18 所 示 。 在 
浏览 器 中 输入 localhost:8080/q2?lastname-Smith, £5 4 nk] 5-19 所 示 。 


j i Ø localhost:8080/save x \T 


€ > Q |Q localhost:8080/save 


Save OK! 


图 5-17 在 浏览 器 中 输入 localhost:8080/save (成 功 增 加 Person) 的 结果 
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/ 2» localhost:8080/q1?first. X NY 


€ > C |O localhost:8080/q1 ?firsthame-Alice 


[l'id':"5b0a5c339513f£351a4fd89ad"', firstName : "Alice", lastName": "Smith | 


图 5-18 浏览 器 中 输入 localhost:8080/q1?firstname-Alice 
(查询 firstname X Alice 的 Person) 的 结果 


/e localhost:8080/q2?last. x IN S 


€ QC © localhost:8080/a2?lastname- Smith 


Person[id -5b0a5c3395131351a4fd89ad, firstName-'Alice', lastName-'Smith'] Person[id-5b0a5c3395131351a4fd89ae, firstName-'Bob', lastName- 'Smith'] 


图 5-19 ”浏览 器 中 输入 localhost:8080/q2?lastname-Smith 
(返回 lastname 为 Smith 的 Person) 的 结果 


5.5.7 ”使 用 REST 方法 访问 MongoDB 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 REST 依赖 ， 代 码 如 
例 5-24 所 示 。 
【 例 5-24] 添加 REST 依赖 的 代码 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-data-rest«/artifactId» 
</dependency> 


修改 接口 PersonRepository， 代 码 如 例 5-25 所 示 。 
【 例 5-25] 修改 接口 PersonRepository 的 代码 示例 。 


package com.bookcode.dao; 

import com.bookcode.entity.Person; 

import org.springframework.data.mongodb.repository.MongoRepository; 

import org.springframework.data.repository.query.Param; 

import org.springframework.data.rest.core.annotation.RepositoryRestResource; 

import java.util.List; 

QGRepositoryRestResource (collectionResourceRel = "people", path = "people") 

// 路 径 

public interface PersonRepository extends MongoRepository«Person, String» ( 
public Person findByFirstName(String firstName); 


public List«Person » findByLastName(8Param("name") String lastName); 


启动 MongoDB 数据 库 ， 运 行程 序 。 为 了 在 Postman 中 增加 “ 张 三 ” 的 信息 ， 输 入 “ 张 
三 ”的 firstName l lastName, HÆ Postman 的 URL 处 输入 http://localhost:8080/people, jf 
选择 POST 方法 ,结果 如 网 5-20 所 示 。 在 Postman [f] URL 处 输入 http://localhost:8080/people， 
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并 选择 GET 方法 ， 结 果 如 图 5-21 所 示 。 为 了 查找 lastName 为 “三 ”的 所 有 people， 先 在 
Postman 的 URL 处 输入 “http:/localhost:8080/people/search/findByLastName?name= 三 ”， 并 
选择 GET 方法 ， 结 果 如 图 5-22 所 示 。 最 终 处 理 结果 在 MongoDB 数据 库 可 视 化 管理 工具 
Robot 3T 中 的 显示 情况 如 图 5-23 所 示 。 


POST http-//localhost-8080/people € 


POST http://localhost:8080/people 


1 ("fir&tName":"Bdk","lastName":"— ") 


5-20 IH] Postman 增加 “ 张 三 ” 的 信息 


GET http//localhost8080/peope — € + *** 
GET "v http://localhost:8080/people 
Key 
Body Cookies Headers (3) Test Results 
Preview JSON v 一 


"firstName": "3k", 


"lastName": " F 


httpy/localhostc808| 6 http://localhost:808! 6 


Authorization 
Type No Auth 


Body Cookies Headers (3) Tests 


lf": { 
“href": "http: //locelhost:8080/people/5b8bf2bc951373080d432c417" 


J 
"person": { 
"href": "http://localhost:8080/people/5b8bf2bc951372300d432c417" 


图 5-22 ”利用 Postman 查找 lastName 为 “三 ”的 所 有 people 


第 5 章 


® Robo 3T - 12 
File View Options Window Help 


C 局 回 B 2 
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v Mylocalmongodb (2) 
> System 
- t3 - I Mylocalmongodb 加 localhost:27017 EE test 
v Collections (2) db.getCollection('r find 
> E dty ET person qv 0.003 sec. 
> BE person 


> Functions Key 
wv © (1) Objectld(" 5bc5e0a3b8aa7b20e899da8c") 


LJ id 


Pa firstName 


> Users 


^" lastName 

t class 
EY (2) Objectld(*5bc5e0a3b8aa7b20e899da8d") 
EY (3) Objectid(5bc5eOabb8aa7b20e899daB8e") 
EY (4) Objectld("5bc5eO0adb8aa7b20e899da8f") 
E (5) Objectld("5bc5e161b8aa7b20e899da90") 
€ (6) Objectld(5bc5e16eb8aa7b20e899da91") 
€3 (7) Objectld(*5bc5e179b8aa7b20e899da92") 
€ (8) Objectid("5bc5e1a0b8aa7b20e899da93") 
€ (9) Objectld("5bc5e24bb8aa7b20e899da94") 
Ey (10) Objectld("5bc5e47bb8aa7b20e899da95") 
Ey (11) Objectid("5bc5e488b8aa7b20e899da96") 
EY (12) Objectld("5bc5e49eb8aa7b20e899da97") 
v Ey (13) Objectid("5bc5e4a6b8aa7b20e899da98") 

LJ id 


"= firstName 


YV āY Y Y Y Y Y Y ™Y vyv vy 


Mo lastName 


t class 


5.6 访问 Neo4j 数据 库 


Neo4j 数据 库 是 一 个 高 性 能 的 NoSQL 图 数据 库 , 并 且 具 备 完全 事务 性 。 
Neo4j 数据 库 将 结构 化 数据 存储 在 一 张 图 上 ,图 中 每 个 结 点 的 属性 表示 数据 
的 内 容 , 每 一 条 有 问 边 表示 数据 的 关系 。Neo4j 数据 库 的 安装 过 程 比较 简单 ， 


本 书 不 做 介绍 。 


5.6.1 ”添加 依赖 


在 pom.xml 文件 中 <dependencles> 和 </dependencies> 之 间 添 加 Neo4j 依赖 ， 代 人 码 如 


例 5-26 所 示 。 
【 例 5-26] 添加 Neo4j 依赖 的 代码 示例 。 


<dependency> 
«groupId»org.springframework.boot«/groupId» 


«artifactId»spring-boot-starter-data-neo4j«/artifactId» 


</dependency> 


5.6.2 ”创建 类 Actor 


在 包 com.bookcode.entity 中 创建 类 Actor， 代 码 如 例 5-27 所 示 。 


Welcone X — Ó db. getCollection( person X Ô db. getCollection( person … x 


Value 


( 4 fields ) 


Objectld("5bc5e0a3b8aa7b20e899da8c") 


Alice 


Smith 


com.bookcode.entity.Person 


( 4 fields ) 
( 4 fields ) 
{ 4 fields ) 
( 2 fields ) 
( 2 fields ) 
( 2 fields ) 
( 2 fields ) 
( 4 fields ) 
( 3 fields ) 
( 3 fields ) 
( 3 fields ) 
( 4 fields ) 


Objectld("5bc5e4a6b8aa7b20e899da98") 


视频 讲解 
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[15] 5-27] 创建 类 Actor 的 代码 示例 。 
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5.6.3 ”创建 接口 ActorRepository 


在 包 com.bookcode.dao 中 创建 接口 ActorRepository， 代 人 码 如 例 5-28 所 示 。 
【 例 S-28】 创建 接口 ActorRepository 的 代码 示例 。 


package com.bookcode.dao; 


import com.bookcode.entity.Actor; 


import org.springframework.data.repository.CrudRepository; 


public interface ActorRepository extends CrudRepository«Actor,Long» ( 


Actor findByName (String name); 


5.6.4 ”修改 配置 文件 application.properties 


在 application.properties 文件 中 配置 Neo4j 数据 源 的 用 户 名 和 密码 ， 端 口 采用 安装 时 的 


默认 亲口 (不 用 配置 )， 其 代码 如 例 5-29 所 示 。 
【 例 S-29】 在 application.properties 文件 中 配置 Neo4] 数据 源 的 代 公 示例 。 
#Neo4j 数据 源 基本 配置 信息 


spring.data.neo4] .username=neo4] 


spring.data.neo4j.password-sa 


5.6.5 ”修改 入 口 类 


修改 入 口 类 ， 代 码 如 例 5-30 所 示 。 
【 例 S-30】 修改 入 口 类 的 代 人 码 示 例 。 


package com.bookcode; 


import com.bookcode.dao.ActorRepository; 


import 
import 
import 
import 
import 
import 


import 


import org.springframework.data.neo4j.repository.config.EnableNeo4jRepositories; 


com. 
org. 
org. 
org- 
grg- 
org. 


org. 


bookcode.entity.Actor; 

slf4j.Logger; 

slf4j.LoggerFactory; 
springframework.boot.CommandLineRunner; 
springframework.boot.SpringApplication; 
springframework.boot.autoconfigure.SpringBootApplication; 


springframework.context.annotation.Bean; 


import org.springframework.transaction.annotation.EnableTransactionManagement; 


import java.util.Arrays; 


import java.util.List; 


QGEnableNeo4jRepositories 


QGSpringBootApplication 


public class DemoApplication { 
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private final static Logger log = LoggerFactory.getLogger (DemoApplication.class); 
public static void main(String[] args) ( 
SpringApplication.run(DemoApplication.class, args); 
) 
QBean 
CommandLineRunner demo (ActorRepository repository) ( 
return args > ( 
repository.deleteAll(); // 辅 助 工 作 ， 删 除 所 有 信息 
Actor greg - new Actor("Greg"); 
Actor roy = new Actor ("Roy"); 
Actor craig - new Actor ("Craig"); 
List«Actor» team = Arrays.asList(greg, roy, craig); 
log.info("Before linking up with Neo4j..."); 
team.stream().forEach(Actor -> log.info("WMt" + Actor.toString())); 
repository.save (greg); 
repository.save (roy); 
repository.save(craig); 
greg - repository.findByName (greg.getName ()); 
greg.worksWith (roy); 
greg.worksWith (craig); 
repository.save (greg); 
roy -repository.findByName (roy.getName ()); 
roy.worksWith (craig); 
repository.save (roy); 
log.info("Lookup each Actor by name..."); 
team.stream().forEach(Actor -» log.info( 


"At" + repository.findByName (Actor.getName () ) .toString())); 


5.6.6 ”运行 程序 


先 在 Windows 命令 处 理 程序 CMD 中 输入 命令 , 启动 Neo4j 数据 库 ， 代码 如 例 5-31 所 
示 。 人 代码 中 的 路 径 和 Neo4j 数据 库 安 装 时 的 路 从 有关。 

【 例 S-31】 局 动 Neo4j 数据 库 命 令 的 代码 示例 。 

cd D:\neo4j-community-3.4.0\bin 

d: 


neo4j console 


运行 程序 , 在 浏览 器 中 输入 http://localhost:7474, 可 以 在 Neo4] 数据 库 的 控制 台中 看 到 
对 Neo4j 数据 库 的 处 理 情况 ， 结 果 如 图 5-24 所 示 。 
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$ MATCH (n:Actor) RETURN n LIMIT 25 


图 5-24 在 浏览 器 中 输入 http://localhost:7474 后 在 Neo4j 控制 台中 
看 到 的 对 Neo4j 数据 库 的 处 理 结果 


5.6.7 利用 REST 方法 访问 Neo4j 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 REST 依赖 ， 代 码 如 
例 5-32 所 示 。 
【 例 $-32】 添加 REST 依赖 的 代码 示例 。 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-data-rest«/artifactId» 
«/dependency» 


在 包 com.bookcode.entity 中 创建 类 Person， 代 人 码 如 例 5-33 所 示 。 
【 例 S-33】 创建 类 Person 的 代码 示例 。 


package com.bookcode.entity; 
import org.neo4j.ogm.annotation.GraphId; 
import org.neo4j.ogm.annotation.NodeEntity; 
QNodeEntity 
public class Person { 
QGGraphId 
private Long id; 
private String firstName; 
private String lastName; 
public String getFirstName() { 
return firstName; 
} 
public void setFirstName(String firstName) { 
this.firstName - firstName; 
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public String getLastName() { 
return lastName; 
} 
public void setLastName (String lastName) { 


this.lastName = lastName; 


} 


在 包 com.bookcode.dao 中 创建 接口 PersonRepository， 代 人 码 如 例 5-34 所 示 。 
【 例 S-34】 创建 接口 PersonRepository 的 代码 示例 。 


package com.bookcode.dao; 
import com.bookcode.entity.Person; 
import org.springframework.data.repository.PagingAndSortingRepository; 
import org.springframework.data.repository.query.Param; 
import org.springframework.data.rest.core.annotation.RepositoryRestResource; 
import java.util.List; 
GRepositoryRestResource (collectionResourceRel = "people", path = "people") 
/ efe 
public interface PersonRepository extends  PagingAndSortingRepository 
«Person, hong» | 

List«Person» findByLastName (@Param ("name") String name); 


} 


在 配置 文件 中 增加 Neo4j 的 配置 信息 ， 代 码 如 例 5-29 所 示 。 
修改 入 口 类 ， 人 代码 如 例 5-35 所 示 。 
【 例 S-3S】 修改 入 口 类 的 代码 示例 。 


package com.bookcode; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.data.neo4j.repository.config.EnableNeo4jRepositories; 
import org.springframework.transaction.annotation.EnableTransactionManagement; 
QGEnableTransactionManagement 
QGEnableNeo4jRepositories 
QGSpringBootApplication 
public class SpringbootDatarestApplication { 

public static void main(String[] args) { 


SpringApplication.run(SpringbootDatarestApplication.class, args); 


} 


启动 Neo4j 数据 库 后 运行 程序 。 为 了 查询 所 有 people 信息 ， 需 要 在 Postman 的 URL 


处 输入 http://localhost:8080/people， 并 选择 GET 方法 ， 结 果 如 图 5-25 所 示 。 增 加 “孙权 ” 
的 记录 时 ， 先 输入 “孙权 ”的 firstName 和 lastName, HÆ Postman 的 URL 处 输入 
http://localhost:8080/people， 并 选择 POST 方法 ， 结 果 如 图 5-26 Pros. X f Æ$ lastName 
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为 “三 ”的 所 有 people， 先 在 Postman 的 URL 处 输入 “http://localhost:8080/people/ 
search/findByLastName?name- — ", 并 选择 GET 方法 , 结果 如 图 5-27 所 示 。 由 于 此 时 Neo4j 
数据 库 中 无 符合 条 件 的 记录 ， 因 此 返回 的 结果 为 空 。 处 理 结果 在 Neo4 数据 库 控制 台中 的 
显示 情况 如 图 5-28 Pray. 


A 


GET http://localhost:8080/people 


Authorization Headers (1) Pre-request Script Tests 


No Auth 


Body Cookies Headers (3) Tests 


Preview JSON "v 一 


"firstName": "iX", 
"lastName": "高 "， 
" links": ( 
"self": ( 
"href": "http: //localhost:80808/people/10" 
» 
"person": 1 
"href": "http: //localhost:8080/people/10" 
h 


"firstName": "$", 
"lastName": "Hf", 
" links": ( 
"self": ( 
"href": "http: //localhost:8080/people/390" 


J> 


5-25 利用 Postman 查询 所 有 people 信息 
POST http-//localhost8080/people ©® 


POST * http://localhost:8080/people 


Body Cookies Headers (4) Test Results 


Preview JSON "v 5 


"firstName": "ph", 
"lastName": "jy", 


5-26 利用 Postman 增加 “孙权 ”信息 的 结果 
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© http://localhost:808|! & 十 


GET v http://localhost:8080/people/search/findByLastName?name- — 


$ Authorization 


No Auth 


" embedded": ( 
"people": [] 


"href": "http://1localhost:8080/people/search/findByLastName?name-XE4XB8X89" 


图 5-27 利用 Postman 查找 lastName 为 “三 ”的 所 有 people 


Database Information 


Node Labels To enjoy the full Neo4j Browser experience, we advise you to 


$ MATCH (n:Person) RETURN n LIMIT 2 
Relationship Types 


Property Keys "firstName": "£X", 


Lr — bd 


"lastName": “局 


Connected as 
"firstName": "3E", 


neo4 | 
aamin 


Q -server user add 


"lastName": "Hg" 


"firstName": " 


图 5-28 ”处 理 结果 在 Neo4j 数据 库 控制 台中 的 显示 情况 
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5.7 访问 数据 库 完 整 示例 


5.7.1 ”添加 依赖 视频 讲解 : 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 JPA, Web kii, ARIB 
如 例 5-36 所 示 。 
【 例 S-36】 添加 JPA、Web 等 依赖 的 代码 示例 。 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-data-jpa«/artifactId» 
</dependency> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-thymeleaf«/artifactId» 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
«artifactId»spring-boot-starter-web«/artifactId» 
</dependency> 
<dependency> 
«groupId»mysql«/groupId» 
«artifactId»mysql-connector-java«/artifactId» 
«/dependency» 


5.7.2 ”创建 类 Book 


在 包 com.bookcode.entity 中 创建 类 Book， 代 码 如 例 5-37 所 示 。 
【 例 5-37] 创建 类 Book 的 代码 示例 。 


package com.bookcode.entity; 

import javax.persistence.*; 

QGEntity 

QTable(name-"t book") 

public class Book { 
@Id 
QGGeneratedValue(strategy = GenerationType.IDENTITY) 
private Integer id; 
QColumn ((length-100) 
private String name; 
QColumn (length-50) 
private String author; 
public Integer getId() { 
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return id; 
} 
public void setId(Integer id) ( 
this.id - id; 
$ } 
à public String getName() { 
return name; 
} 
public void setName (String name) { 
this.name = name; 
} 
public String getAuthor() { 
return author; 
} 
public void setAuthor (String author) { 
this.author = author; 


5.7.3 创建 接口 BookDao 


在 包 com.bookcode.dao 中 创建 接口 BookDao, [Vip] 5-38 所 示 。 
【 例 S-38】 创建 接口 BookDao 的 代码 示例 。 


package com.bookcode.dao; 
import com.bookcode.entity.Book; 
import org.springframework.data.jpa.repository.JpaRepository; 
import org.springframework.data.jpa.repository.JpaSpecificationExecutor; 
import org.springframework.data.jpa.repository.Query; 
import java.util.List; 
public interface BookDao extends JpaRepository«Book, Integer», JpaSpecification- 
Executor«Book» ( 
QQuery (value = "select * from t book where t book.name like $%?1% ", 
nativeQuery - true) 
// 或 者 @Query ("select b from Book b where b.name like $?12") 
public List«Book» findByName (String name); 
/ /nativeQuery 默认 是 HQL frif], true 表示 使 用 本 地 查询 ， 就 是 原生 的 SQL 方式 
@Query (value = "select * from t book ORDER BY RAND( ) limit ?1 ", 
nativeQuery - true) 
public List«Book» randomList(Integer id); 


5.7.4 ”修改 配置 文件 application.properties 


修改 配置 文件 application.properties， 代 人 码 如 例 5-39 所 示 。 
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【 例 S-39】 修改 配置 文件 application.properties 的 代码 示例 。 


spring.datasource.dbcp2.driver-class-name-com.mysql.jdbc.Driver 


spring.datasource.url-jdbc:mysql://localhost:3306/mytest 


spring.datasource.username-root 


spring.datasource.password-sa 


spring.jpa.hibernate.ddl-auto-update 


spring.jpa.show-sql-true 


也 可 以 将 application.properties 文件 改写 成 application. yml, REE ini] 5-40 所 示 。 
【 例 S-40】 改写 配置 文件 application.yml 的 代码 示例 。 


spring: 


datasource: 


driver-class-name: com.mysql.jdbc.Driver 
url: jdbc:mysql://localhost:3306/mytest 
username: root 


password: sa 
jpa: 
hibernate: 


ddl-auto: update 


show-sql: true 


ms 


创建 类 BookController 


在 包 com.bookcode.controller 中 创建 类 BookController， 代 码 如 例 5-41 所 示 。 
【 例 5-41] 创建 类 BookController 的 代码 示例 。 


package com.bookcode.controller; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


import 


com.bookcode.dao.BookDao; 
com.bookcode.entity.Book; 
org.springframework.data.jpa.domain.Specification; 
org.springframework.stereotype.Controller; 
org.springframework.web.bind.annotation.*; 
org.springframework.web.servlet.ModelAndView; 
javax.annotation.Resource; 
javax.persistence.criteria.CriteriaBuilder; 
javax.persistence.criteria.CriteriaQuery; 
javax.persistence.criteria.Root; 
java.util.List; 


javax.persistence.criteria.Predicate; 


// 图 书 控制 器 
@Controller 
@RequestMapping ("/book") 


public 


class BookController { 


QResource 
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private BookDao bookDao; 
// 但 询 所 有 图 书 
QRequestMapping ("/list") 
public ModelAndView list()( 
E ModelAndView mav-new ModelAndView(); 
t mav.addObject("booklist", bookDao.findAl1()); 
mav.setViewName ("bookList"); 


return mav; 


} 
// 添 加 图 书 
@RequestMapping (value="/add",method=RequestMethod. POST) 
public String add (Book book){ 
bookDao.save (book); 


return "Foreard /Door/liiost"™ 


} 

// 根 据 id 查询 book 实体 

@RequestMapping ("/preUpdate/(id)") 

public ModelAndView PreUpdate (GPathVariable("id")Integer 1d) { 
ModelAndView mav-new ModelAndView(); 
mav.addObject ("book", bookDao.getOne (id)); 
mav.setViewName ("bookUpdate"); 


return mav; 


} 
// 修 改 图 书 
QPostMapping (value-"/update") 
public String update (Book book)(|( 
bookDao.save (book) ; 
return "forward:/book/list"; 
} 
// 删 除 图 书 
QGetMapping ("/delete") 
public String delete(Integer id)( 
bookDao.deleteById (id); 
return "forward:/book/list"; 
} 
// 根 据 条 件 动态 查询 
QGRequestMapping ("/list2") 
public ModelAndView list2 (Book book) { 
ModelAndView mav = new ModelAndView(); 
List«Book» bookList = bookDao.findAll(new Specification«Book» (){ 
QOverride 
public Predicate toPredicate(Root«Book» root, CriteriaQuery«?» 


query, CriteriaBuilder cb) 


Predicate predicate - cb.conjunction(); 


第 5 章 Spring Boot 的 数据 库 访 问 


1f (book!2null)|( 


if(book.getName()!-null && !"".equals(book.getName()))( 


predicate.getExpressions().add(cb.like(root.get ("name"), 


book.getName () *"$")); 
} 


DUE 


if(book.getAuthor()!-null && !"".equals (book.getAuthor ()))( 
predicate.getExpressions().add(cb.like(root.get("author"), "£"4 


book.getAuthor () *"$")); 
} 
} 


return predicate; 


)); 

mav.addObject ("book", book); 
mav.addObject("booklist", bookList); 
mav.setViewName ("booklist"); 

return mav; 


} 

/ / fri] 

QResponseBody 

QGRequestMapping ("/query") 

public List«Book» findByName (String name) { 
return bookDao.findByName ("lH"); 

} 

// 随 机 显示 

QResponseBody 

QRequestMapping ("/randomlist") 

public List«Book» randomList(String name)( 
return bookDao.randomList (2); 


5.7.6 ”创建 文件 bookAdd.html 


在 resources/static 目录 下 创建 文件 bookAdd.html， 代 人 码 如 例 5-42 所 示 。 


【 例 5-42] 创建 文件 bookAdd.html 的 代码 示例 。 


«'!DOCTYPE html» 

<html> 

<head> 

<meta charset="UTF-8"> 

<title>Insert title here</title> 

</head> 

<body> 

«form action-"/book/add" method-"post"» 
RPA: «input type-"text" name-"name"/»«br/» 
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Kl-BÁÍESd: «input type-"text" name-"author"/»«br/» 
«input type="submit" value=" 提 交 "/> 
«/form» 
«/body» 
$ </html> 


5.7.7 ”创建 文件 bookList.html 


在 resources/templates 目录 下 创建 文件 bookListhtml， 人 代码 如 例 5-43 所 示 。 
【 例 5-43] 创建 文件 bookList.html [fV 837549]. 


<!DOCTYPE html» 
«html xmlns-"http://www.w3.org/1999/xhtml" xml1ns:th-"http://www.thymeleaf.org" > 
«head» 
«meta charset-"UTF-8"» 
<title> 图 书 管理 </title> 
</head> 
<body> 
«a href="/bookAdd.html"> 添 加 </a><br/> 
<table> 
CLP 
<th> 编 号 </th> 
<th> 图 书 名 称 </th> 
<th> 图 书 作 者 </th> 
<th> 操 作 </th> 
c E 
<p th:each ="book:${booklist}" > 
A E 
«td th:text -"S$(book.idj)"»«/td» 
«td th:text -"S(book.name)"»«/td» 
«td th:text -"S$S(book.authorj)"»«/td» 
«td» 
«a th:href-"'/book/preUpdate/'-4$(book.id)"»1EU«/a» 
«a th:href-"'/book/delete?id-'«$(book.id) "5A ER«/a» 
«/td» 
CILE 
«/p» 
</table> 
</body> 
</html> 


5.7.8 创建 文件 bookUpdate.html 


在 resources/templates 目录 下 创建 文件 bookUpdate.html， 代 码 如 例 5-44 所 示 。 
【 例 5-44] 创建 文件 bookUpdate.html HJARA ZK 
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<!DOCTYPE html» 

<html xmlns-"http://www.w3.org/1999/xhtml" xmlns:th-"http://www.thymeleaf.org" > 
«head» 

«meta charset-"UTF-8"» 

<title> 图 书 修改 </title> 

</head> 


< 


<body> 

<form th:action="'/book/update'" th:method="post"> 
«input th:type="hidden" th:name-"id" th:value="${book.id}"/> 
RPA: «input th:type-"text" th:name-"name" th:value-"$(book.namej"/»«br/» 
Pia: «input th:type-"text" th:name-"author" th:value-"$(book.author]"/» 
<br/> 
«input th:type-"submit" th:value-"d"/» 

«/form» 

«/body» 

«/html» 


57. ”运行 程序 


运行 程序 后 在 浏览 器 中 输入 localhost:8080/book/list 或 者 localhost:8080/book/list2， 结 
果 如 图 5-29 所 示 。 进 行 删 除 操作 时 《以 删除 第 6 条 记录 为 例 )， 在 浏览 器 中 输入 
localhost:8080/book/delete?id=6， 结 果 如 图 5-30 所 示 。 单 击 “ 添 加 ”链接 后 ,浏览 器 中 显示 
为 localhost:8080/bookAdd.html, 结果 如 图 5-31 所 示 。 输入 图 书 名 称 、 图 书 作 者 后 单 击 “ 提 
交 ” 按 钮 ， 结 果 如 图 5-32 所 示 。 单 击 第 12 条 图 书记 录 后 和 面 的 “修改 ”链接 后 ， 结 果 如 
图 5-33 所 示 。 输入 修改 的 第 12 条 图 书记 录 信 息 后 单 击 “ 提 交 ” 按 钮 ,结果 如 图 5-34 Pros. 
在 浏览 器 中 输入 localhost:8080/book/query 后 输出 的 是 图 书 名 称 中 含 “ 思 想 ” 的 图 书信 息 ， 
结果 如 图 5-35 所 和 示 。 在 浏览 器 中 输入 localhost:8080/book/randomlist 后 随机 得 到 的 两 本 图 
书记 录 信 息 ， 结 果 如 图 5-36 Wr. 


/ gi mser x V 


n 
V 


€ © | © localhost:8080/book/list 


添加 


编号 图 书 名 称 图 书 作 者 。 操作 
Java 编 程 思想 Beck 小 二 修改 删除 
PHP 编 程 老 王 修改 删除 
Spring Boot 张 三 修改 删除 
Spring zh 修改 删除 
SpringMVC 赵 修改 删除 
Spring Book in Action Criag 张 伟 修改 删除 
WS WS 修改 删除 


图 5-29 ”在 浏览 器 中 输入 localhost:8080/book/list (显示 所 有 图 书 ) 的 结果 
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€ G © localhost:8080/book/delete?id-6 


号 图 书 名 称 图 书 作 者 。 操作 
Java 编 程 思想 Beck 小 二 修改 删除 
PHP 编 程 老 王 修改 删除 
Spring Boot 张 三 修改 删除 
Spring 于 五 修改 删除 
SpringMVC 赵 修改 删除 
Spring Book in Action Criag 张 伟 修改 删除 
WS WS 修改 删除 


— -全 


/ gg Insert title here 


c dr | © localhost:8080/bookAdd.html 


图 书 名 称 : 
图 书 作者 : 


图 5-31 单 击 “添加 ”链接 后 跳 转 到 添加 图 书信 息 的 界面 


/ eh 图 书 管理 x WEB 
€ > CŒ |O localhost:8080/book/add 


BBM ER 图 书 作者 — 操作 
Java 编 程 思想 Beck 小 二 修改 删除 
PHP 编程 Er 


Spring Boot 张 二 

Spring TA 

SpringMVC 

Spring Book in Action Criag 张 伟 修改 删除 
WS WS 修改 删除 
Spring Book Cookbook cv 修改 删除 


图 5-32 ”输入 图 书 名 称 、 图 书 作 者 后 单 击 “提交 ”按钮 《成 功 添加 图 书 ) 的 结果 
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€ > C |O localhost:8080/book/preUpdate/12 


图 书 名 称 : 
EBER: we | 


图 5-33 单 击 第 12 条 图 书记 录 后 面 的 “修改 ”链接 后 《修改 第 12 条 记录 ) 的 结果 


FT A 
€ > C |O locaihost8080/book/update — 


图 书 名 称 图 书 作者 。 操作 

Java 编 程 思 想 Beck 小 二 修改 删除 
PHP 编 程 BE 

Spring Boot 张 二 

Spring amal 

SpringMVC EX 

Spring Book in Action  Criag 张 伟 修改 删除 
Spring MVC with Boot ws 修改 删除 
Spring Book Cookbook cv 修改 删除 


图 5-34 输入 修改 的 第 12 条 图 书记 录 信 息 后 单 击 “提交 ”按钮 
(成 功 修改 第 12 条 记录 ) 的 结果 


© localhost:8080/book/query 


[ ^ id": 1, "name" : " Javai ii EB.28", "author": "Beck 小 二 ”1}] 


5-35 在 浏览 器 中 输入 localhost:8080/book/query 的 输出 
(所 有 名 称 中 含 “ 思 想 ” 的 图 书 ) 


/ gi localhost:8080/book/r- x \ WE 


€ C |© localhost:8080/book/randomlist 


[ lid": 10, "name": "SpringWWC", "author" :" £6], (id':12, "name": "Spring MWC with Boot”, "author" :"ws"]] 


图 5-36 在 浏览 器 中 输入 localhost:8080/book/randomlist 
后 随机 得 到 的 两 本 图 书记 录 信 息 
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2j S 


简 答 题 

l. Hj NoSQL 数据 库 的 特点 和 适用 环境 。 

2. RX) JPA 和 Spring Data JPA 的 理解 。 

实现 用 JDBC 方式 访问 H2 数据 库 。 

实现 用 Spring Data JPA 访问 H2 数据 库 。 

实现 用 RESTful 和 Spring Data JPA 访问 H2 数据 库 。 

安装 工具 Postman， 并 结合 实例 使 用 它 。 

安装 数据 库 MySQL 和 可 视 化 管理 工具 Navicat for MySQL， 并 结合 实例 使 用 它 。 
实现 使 用 Spring Data JPA 方式 访问 MySQL 数据 库 。 

安装 数据 库 MongoDB 和 可 视 化 管理 工具 Robo 3T， 并 结合 实例 使 用 它 。 
实现 对 MongoDB 数据 库 的 访问 。 

. 安装 数 据 库 Neo4j。 

10. 实现 对 Neo4j 数据 库 的 访问 。 


— < 
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Web 服务 (Web Service) 是 一 个 平台 独立 、 低 耦合 、 自 包含 的 Web 应 用 程序 ， 可 使 用 
开放 的 XML (可 扩展 标记 语言 ) 标准 来 描述 、 发 布 、 发 现 、 协 调和 配置 这 些 应 用 程序 。 
Web 服务 能 使 运行 在 不 同 机 器 上 的 应 用 无 须 借助 附加 的 软件 或 硬件 ， 就 可 以 相互 交换 数据 
或 集成 。 只 要 是 依据 Web 服务 规范 实现 的 Web 服务 ， 彼 此 之 间 就 可 以 透明 地 相互 交换 数 
据 ， 而 不 用 关注 实现 的 语言 、 平 台 或 内 部 协议 。Web 服务 很 容易 部 署 ， 因 为 它们 基于 一 些 


本 章 主要 介绍 如 何 实 现 RESTful 风格 Web 服务 , 依次 介绍 如 何 基 于 Jersey KI RESTful 
风格 Web 服务 、 如 何 使 用 RESTful 风格 Web 服务 、 如 何 使 用 融 AngularJS 的 RESTful 风格 
Web 服务 、 如 何 基 于 Actuator 实现 RESTful 风格 Web 服务 、 如 何 实现 跨 域 资源 共享 的 
RESTful 风格 Web 服务 、 如 何 实现 超 媒 体 驱 动 的 RESTful 风格 Web 服务 、 如 何 整 合 CFX 
实现 Web 服务 开发 。 


6.1 基于 Jersey 实现 RESTful 风格 Web 服务 


Jersey 框 架 是 开源 的 RESTful 框架 ,实现 了 JAX-RSCJSR 311 和 JSR 339) 
规范 。 它 扩展 了 JAX-RS 参考 实现 ， 提供 了 更 多 的 特性 和 工具 ， 可 以 进 一 
步 地 简化 RESTA 服务 和 客户 端 开发 。 尽 管 相对 年 轻 ， 它 已 经 是 一 个 产品 级 的 RESTful 
服务 和 客户 病 框 架 。 与 Struts 类 似 ， 它 同样 可 以 和 Hibernate. Spring 框架 整合 。 


6.1.1. Zik 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 Jersey、Fastjson 依赖 ， 
代码 如 例 6-1 所 示 。 
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【 例 6-1】 添加 Jersey, Fastjson 依赖 的 代 人 码 示例 。 


<dependency> 
«groupId»org.springframework.boot«/groupId» 


i «artifactId»spring-boot-starter-jersey«/artifactId» 
B </dependency> 
<dependency> 


<groupId>com.alibaba</groupId> 
«artifactId»fastjson«/artifactId» 
«version»1.2.50«/version» 


«/dependency» 


6.1.2 ”创建 类 Constant 


在 com.bookcode.constant 包 中 创建 类 Constant, fV 6-2 所 示 。 
【 例 6-2】 创建 类 Constant 的 代码 示例 。 


package com.bookcode.constant; 
import java.util.HashMap; 
import java.util.Map; 
public class Constant ( 
public static final String name - "XX"; 
public static final Map«String,Object» map; 
StuLTETI 
map = new HashMap«cString, Object»(); 
map.put ("歌手 "，name); 
map.put ("歌曲 "， "被 遗 态 的 时 光 "); 


6.1.3 创建 类 JerseyController 


在 包 com.bookcode.config 中 创建 类 JerseyController， 代 码 如 例 6-3 所 示 。 
【 例 6-3】 创建 类 JerseyController 的 代码 示例 。 


package com.bookcode.controller; 

import com.bookcode.constant.Constant; 

import org.springframework.web.bind.annotation.RestController; 
import javax.ws.rs.*; 

import javax.ws.rs.core.MediaType; 

import java.util.Map; 

import com.alibaba.fastjson.JSON; 


// 所 有 注册 的 端点 都 应 该 被 GComponents 和 HTTP 资源 annotations (如 @GET) 注解 
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QRestController 
@Path ("/jersey") 
public class JerseyController { 
QGET 
QPath("/get") 
QGConsumes ((MediaType.APPLICATION XML, MediaType.APPLICATION JSON}) 
QGProduces (MediaType.APPLICATION JSON) 
public Map«String, Object» getMessage() ( 
return Constant.map; 
} 
/ / POST 形式 在 浏览 器 地 址 栏 中 输入 请 求 路 径 不 一 定 能 访问 到 。 推 荐 用 Fiddler 工具 或 者 Firefox 浏览 
// 器 插件 (poster 或 HttpRequester) 
QPOST 
QPath("/post") 
QGConsumes ((MediaType.APPLICATION XML, MediaType.APPLICATION JSON]) 
QGProduces (MediaType.APPLICATION JSON) 
public Map«String, Object» postMessage (Map«String,Object» param) ( 
System.out.println(JSON.toJSONString (param)); 
return Constant.map; 


6.1.4 创建 类 Jersey Config 


在 包 com.bookcode.config 中 创建 类 JerseyConfig， 代 码 如 例 6-4 所 示 。 
【 例 6-4] 创建 类 JerseyConfig 的 代码 示例 。 


package com.bookcode.config; 
import com.bookcode.controller.JerseyController; 
import org.glassfish.jersey.server.ResourceConfig; 
import org.springframework.context.annotation.Configuration; 
import javax.ws.rs.ApplicationPath; 
/* 想 要 开始 使 用 Jersey 2.x 只 需要 加 入 依赖 ， 然 后 需要 一 个 ResourceConfig 类 型 的 @Bean,， 
用 于 注册 所 有 的 端点 Cendpoints,demo 为 JerseyController). 
d 
QGConfiguration 
//Jersey Servlet 将 被 注册 并 默认 映射 到 /*。Q&aApplicationPath 添加 到 ResourceConfig 
// 改 变 该 映射 
QGApplicationPath("/rest") 
public class JerseyConfig extends ResourceConfig { 
public JerseyConfig() ( 


register(JerseyController.class); 
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6.1.5 


修改 入 口 类 


修改 入 口 类 ， 代 人 码 如 例 6-5 所 示 。 
【 例 6-$】 修改 入 口 类 的 代码 示例 。 


package com.bookcode; 


import 
import 
import 
import 
import 


import 


com.bookcode.config.JerseyConfig; 
org.glassfish.jersey.servlet.ServletContainer; 
org.glassfish.jersey.servlet.ServletProperties; 
org.springframework.boot.SpringApplication; 
org.springframework.boot.autoconfigure.SpringBootApplication; 


org.springframework.boot.web.servlet.ServletRegistrationBean; 


QGSpringBootApplication 


public 


class DemoApplication { 


public ServletRegistrationBean jerseyServlet() { 


} 


ServletRegistrationBean registration - new ServletRegistrationBean( 
new ServletContainer(), "/rest/*"); 


// rest 资源 可 以 在 /rest/*#* 路 径 下 访问 
registration.addInitParameter (ServletProperties.JAXRS APPLICATION CLASS, 
JerseyConfig.class.getName()); 


return registration; 


public static void main(String[] args) I 


6.1.6 


SpringApplication.run(DemoApplication.class, args); 


运行 程序 


运行 程序 后 ,在 浏览 器 中 输入 http://localhost:8080/rest/jersey/get, £5 Ri JSON 格式 的 
字符 串 ， 如 图 6-1 所 示 。 在 Postman 中 选择 POST 方法 ， 在 URL 处 输入 
http://localhost:8080/rest/jersey/post， 并 输入 JSON ATZE “(P "g" "a H": 
" 张 三 的 歌 "}”， 如 图 6-2 Hrzs. fE Postman 中 完成 操作 后 ， 在 控制 台 的 输出 结果 如 图 6-3 


所 示 。 


[4 localhost:8080/rest/Jer: X 


C | © localhost:8080/rest/jersey/get 


PRF E REGERE Eod: 


图 6-1 在 浏览 器 中 输入 http://localhost:8080/rest/jersey/get 的 结果 
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POST * http://localhost:8080/rest/jersey/post Params 


Authorization eaders (1) Pre-request Script 
Ó— 


O form-data 9 x-www-form-urlencoded ® raw © binary  JSON(application/json) v 


1 ("EUR BsK- 99) 


— < 


图 6-3 ”在 Postman 中 完成 操作 后 控制 台 的 输出 结果 


6.1.7 补充 说 明 


现在 前 端 流 行 的 是 静态 HTML+ REST 接口 (JSON 格式 )。 如 果 是 单 台 服务 器 ， 用 动 
态 页 面 还 是 静态 页 面 可 能 区 别 不 大 , 但 是 如 条 服务 器 用 到 了 集群 、 负 载 均 衡 、CDN 等 技术 ， 
用 动态 页 和 面 还 是 静态 页 面 差别 很 大 。 建 议 尽 量 使 用 HIML+REST 接口 来 实现 Web 服务 。 

REST 接口 有 两 种 实现 方法 : 传统 实现 方法 和 新 的 实现 方法 。 传 统 实现 方法 的 代码 如 
例 6-6 所 示 。 

【 例 6-6】 REST 接口 传统 实现 方法 的 代码 示例 。 


package com.bookcode.controller; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.ResponseBody; 
// 注 册 一 个 spring 控制 层 Bean 
QController 
public class HelloController { 

// 配 置 方法 的 Post 请 求 URL 

GRequestMapping(value- "/url/hello",method-RequestMethod.POST) 

// 将 这 个 方法 的 返回 值 转换 成 特定 格式 ， 默 认 是 JSON 

QResponseBody 

/ /user 用 来 接收 前 端 请 求 的 相关 传 参 ， 如 form 表单 中 的 参数 

public String hello (User User) { 

return "hello world"; 


} 


新 的 实现 方法 代码 如 例 6-7 所 示 ， 新 的 实现 方法 利用 几 个 新 的 注解 简化 了 传统 的 实现 
方法 。 
【 例 6-7】 REST 接口 新 的 实现 方法 的 代码 示例 。 
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package com.bookcode.controller; 
import org.springframework.web.bind.annotation.PostMapping; 
import org.springframework.web.bind.annotation.RequestBody; 
import org.springframework.web.bind.annotation.RestController; 
/ /&Controller«G8ResponseBody 组 合 ， 相 当 于 在 每 个 方法 中 都 加 上 ResponseBody 
QGRestController 
public class HiController { 

// 直 接 指定 Post 请 求 ， 同 样 也 有 @GetMapping 

QPostMapping ("/url/hi") 

/ / eRequest Body 指 请 求 来 的 参数 是 JSON 格式 ， 以 ISON 格式 来 转换 到 user， 用 JSON f£ 

// 参 已 经 越 来 越 多 

public String hi(8RequestBody User User) { 

return "hi"; 


6.2 ”使 用 RESTful 风格 Web 服务 


可 以 创建 应 用 程序 来 使 用 已 有 的 RESTful 风格 Web 服务 ， 本 节 介 绍 如 
何 使 用 网 上 (http:/gturnquist-quoters.cfapps.io/apirandom ) 己 有 的 Web 服务 。 视频 讲解 


6.2.1 网 上 已 有 Web 服务 random 的 说 明 
网 上 gturnquist-quoters.cfapps.io/api/random 的 已 有 Web 服务 random， 可 以 随机 地 获取 


关于 Spring Boot 的 引用 ,通过 在 浏览 需 中 请 求 该 URL， 可 能 的 结 朱 如 图 6-4 Hrs CERE 
随机 的 )。 


图 6-4 通过 浏览 器 访问 gturnquist-quoters.cfapps.io/api/random 的 random 服务 的 结果 


6.2. ”创建 类 Quote 


以 编程 方式 可 以 更 方便 、 有 效 地 使 用 RESTful 风格 Web 服务 。 为 了 帮助 开发 者 更 好 地 
完成 该 任务 ，Spring 提供 了 一 个 方便 的 REST 模板 RestTemplate。RestTemplate 模板 使 得 能 
以 非常 少 的 代码 (甚至 是 一 行 代码 ) 与 大 多 数 RESTful 风格 Web 服务 进行 交互 ， 它 甚至 可 
以 将 返回 的 JSON 数据 绑 定 到 目 定 义 的 领域 实体 关上 。 于 是 , 使 用 RESTful 风格 Web 服务 
时 ,需要 创建 一 个 用 来 封装 返回 JSON 数据 的 领域 实体 类 。 因 此 ， 使 用 random 服务 时 ， 首 
先 在 包 com.bookcode.entity 中 创建 Quote 类 来 封装 random 服务 返回 的 JSON 数据 (如 
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图 6-4 所 示 的 结果 )。 类 Quote 的 代码 如 例 6-8 所 示 。 


【 例 6-8】 类 Quote 的 代码 示例 。 


package com.bookcode.entity; 
import com.fasterxml.jackson.annotation.JsonIgnoreProperties; 
QGJsonIgnoreProperties(ignoreUnknown = true) // 忽 略 类 中 不 存在 的 字段 
public class Quote { 
private String type; 
private Value value; // 需 要 创建 类 
public Quote() ( } 
public String getType() ( 
return type; 
} 
public void setType (String type) ( 
this.type - type; 
} 
public Value getValue() ( 
return value; 
) 
public void setValue(Value value) { 
this.value - value; 
} 
QOverride 
public String toString() ( 


return "Ouote(" T"Lype-' "n 2 type ras ' X rh E wales" 二 value E ' } LI » 


6.2.3 创建 类 Value 


为 了 生 接 将 数据 绑 定 到 目 定义 类 型 ， 青 要 指定 与 API 返回 JSON 数据 中 的 键 完 全 相同 


的 变量 名 。 如 果 JSON 数据 中 的 变量 名 和 密 钥 不 匹配 ， 则 需要 使 用 注解 @JsonProperty 来 忽 
略 类 中 不 存在 的 字段 。 为 了 和 返回 结果 Quote 类 内 的 属性 值 对 应 ， 需 要 一 个 额外 的 Value 
类 。 于 是 ， 在 包 com.bookcode.entity 中 创建 辅助 类 Value， 代 码 如 例 6-9 所 示 。 


【 例 6-9】 创建 辅助 类 Value 的 代 人 码 示例 。 


package com.bookcode.entity; 
import com.fasterxml.jackson.annotation.JsonIgnoreProperties; 
QGJsonIgnoreProperties(ignoreUnknown = true) // 忽 略 类 中 不 存在 的 字段 
public class Value { 

private Long id; 

private String quote; 

public Value() { ] 

public Long getId() ( 
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return this.id; 
} 
public String getQuote() { 
return this.quote; 
$ } 
à public void setId(Long id) { 
this.id - id; 
} 
public void setQuote(String quote) ( 
this.quote - quote; 
} 
QOverride 
public String toString() ( 


return "Value([" -"id-" + id +", quote-'" + quote + '\'' +'}'; 


6.2.4 IWA nO% 


修改 入 口 类 ， 代 码 如 例 6-10 所 示 。 
【 例 6-10】 修改 入 口 类 的 代码 示例 。 


package com.bookcode 
import org.springframework.context.annotation.Bean; 
import org.springframework.web.client.RestTemplate; 
QGSpringBootApplication //Spring Boot 应 用 局 动 注解 
public class SpringbootHelloworldsApplication { 
private static final Logger log = LoggerFactory.getLogger (Springboot 
HelloworldsApplication.class); 
public static void main(String[] args) ( 
SpringApplication.run(SpringbootHelloworldsApplication.class,args); 
} 
@Bean / / Bean 注解 
public RestTemplate restTemplate (RestTemplateBuilder builder) { 
return builder.build(); 
} 
QBean / /Bean 注解 
public CommandLineRunner run(RestTemplate restTemplate) throws Exception { 
return args >f 
Quote quote - restTemplate.getForObject( 
"http://gturnquist-quoters.cfapps.io/api/random", Quote.class); 
/ / H Quote 封装 random 返回 JSON 
log.info (quote.toString () //} Quote 信息 (返回 的 Json 数据 ) 作为 日 志 记 录 到 控制 台 
) 7 
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62.5 ”运行 程序 


访问 已 经 存在 的 名 为 random 的 Web 服务 将 获得 JSON 数据 ， 模 板 RestTemplate 使 用 
位 于 classpath 中 的 Jackson JSON 处 理 库 将 JSON 数据 转换 为 Quote XZ. E244, Quote 对 
象 的 内 容 被 输出 到 控制 侣 ， 结 果 如 图 6-5 所 示 。 


图 6-5 在 控制 台 输 出 Quote 对 象 的 内 容 〈 由 访问 名 为 random 的 
Web 服务 获得 的 JSON 数据 转换 而 成 ) 


由 次 , OR SEDI Vi 6 UJ [n] Cgturnquist-quoters.cfapps.io/api/random) 己 有 Web 服务 random, 
可 能 的 结果 如 图 6-6。 对 比 图 6-4, El 6-5 和 图 6-6， 可 以 发 现 返 回 的 JSON 数据 是 随机 的 。 


/ Ø gturnquist-quoters.cía; X A \ n 


«€ G | © aturnquist-quoters.cfappso/api/random 


Utype "success", "value" : [1307 :12. "quote": "üsnrinzboct with üspringfranework is pure productivity! Who said in #java one has to write double tbe code than in ctber langs? HSnewFzvLih']] 


图 6-6 ”通过 浏览 器 访问 Cgturnquist-quoters.cfapps.io/api/random ) 
Web 服务 random 的 可 能 结果 


6.3 ”使 用 带 AngularJS 的 RESTful 风格 Web 服务 


AngularJS 诞生 于 2009 年 ， 由 Misko Hevery 等 人 创建 ， 后 被 Google 

公司 收购 。 它 是 一 款 以 JavaScript 编写 的 优秀 前 端 JavaScript 框架 ， 已 经 被 POSUERE 
用 于 Google 公司 的 多 于 产品 当中 。AngularJS 有 大庄 多 特性 ， 最 为 核心 的 包括 MVW 
(Model-View-Whatever)、 模 块 化 、 目 动 化 双 癌 数据 绑 定 、 语 义 化 标签 、 依 赖 注入 等 。 它 可 
通过 <script> </script> 标签 添加 到 HTML 页 面 。AngularJS 通过 为 开 友 者 呈现 一 个 更 高 层 
次 的 抽象 来 简化 应 用 开发 。 AngularJS 主要 考虑 的 是 构建 CRUD (Create, 增加; Retrieve, 
AU; Update， 更 新 ;Delete， 删除) 应用。 构建 一 个 基于 AngularJS 的 CRUD 应 用 可 能 
到 的 全 部 内 容 包 括 数 据 绑 定 、 基 本 模板 标识 从 、 表 单 验 证 、 路 由 、 深 度 链 接 、 组 件 重 用 等 。 
本 市 使 用 的 服务 是 http://rest-service.guides.spring.i0/greeting。 


6.3.1 ”添加 依赖 和 辅助 文件 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 对 Web 的 依赖 。 下 载 
AngularJS 并 将 其 添加 resources/static/js 目录 下 。 


6.3.» ”创建 文件 ajs.html 


在 resources/static 目录 下 创建 文件 ajs.html， 代 人 码 如 例 6-11 所 示 。 
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【 例 6-11】 创建 文件 ajs.html 的 代码 示例 。 


<!doctype html» 
«html ng-app-"demo"» 
«head» 
i «meta charset-"UTF-8"/» 
<title> 调 用 已 有 的 web 服务 且 使 用 AngularJS«/title» 
«script src-"/js/angular.min.js"»«/script» 
«Script» 
angular.module('demo', []) 
.controller('Hello', function($scope, $http) ( 
Shttp.get('http://rest-service.guides.spring.io/greeting'). 
then (function (response) { 
$scope.greeting = response.data; 
)); 
)); 
«/script» 
</head> 
<body> 
<div ng-controller="Hello"> 
<h2> 调 用 已 有 的 web 服务 且 使 用 AngularJS</h2> 
<p>The ID is ((greeting.id]])«/p» 
<p>The content is ((greeting.content]])«/p» 
«/div» 
«/body» 
«/html» 


6.3.3 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/ajs.html， 结 果 如 图 6-7 所 示 。 


/ 2i 调用 已 有 的 Web 服 务 且 售 x NW 


€ > Q |O localhost:8080/ajs.html 


调用 已 有 的 Web 服 务 且 使 用 AngularJs 


The ID is 215 


The content is Hello, World! 


图 6-7 在 浏览 器 中 输入 localhost:8080/ajs.html 的 结果 
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6.4 基于 Actuator 实现 RESTful 风格 Web 服务 


Spring Boot 的 spring-boot-actuator 模块 可 以 对 服务 做 更 好 的 监控 和 性 SPENGE 
能 查看 , 可 以 在 应 用 投入 生产 时 监视 和 管理 应 用 程序 , 可 以 查看 服务 间 的 数 pe 4 
据 处 理 和 调用 。 当 出 现 异常 时 ， 就 可 以 快速 定位 到 出 现 问 题 的 地 方 。 gi 


6.4.1 添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ， 代 码 如 例 6-12 
所 示 。 
【 例 6-12】 添加 依赖 的 代码 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-actuator«/artifactId» 
«/dependency» 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 
«/dependency» 


6.4.2 ”创建 类 Greeting 


在 com.bookcode.entity 包 中 创建 类 Greeting, £C rp 6-13 所 示 。 
【 例 6-13] 创建 类 Greeting 的 代 但 示例 。 


package com.bookcode.entity; 
public class Greeting { 
private final long id; 
private final String content; 
public Greeting(long id, String content) { 
this.id - id; 
this.content - content; 
} 
public long getId() { 
return id; 
} 
public String getContent() { 


return content; 
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6.4.3 创建 类 GreetingController 


创建 类 GreetingController， 代 码 如 例 6-14 所 示 。 
【 例 6-14] 创建 类 GreetingController 的 代码 示例 。 


package com.bookcode.controller; 

import com.bookcode.entity.Greeting; 

import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.RequestParam; 
import org.springframework.web.bind.annotation.ResponseBody; 
import java.util.concurrent.atomic.AtomicLong; 


QGController 
public class GreetingController { 
private static final String template - "Hello, $s!"; 


private final AtomicLong counter - new AtomicLong(); 
QGetMapping ("/hello-world") 
QResponseBody 
public Greeting sayHello(8RequestParam(name-"name", required-false, 
defaultValue-"Stranger") String name) { 
return new Greeting(counter.incrementAndGet(), String.format 
(template, name)); 


6.4.4 ”修改 配置 文件 application.properties 


修改 配置 文件 appllicatton.properties， 代 码 如 例 6-15 所 示 。 
【 例 6-15] 修改 配置 文件 application properties 的 代码 示例 。 


server.port: 9000 
management.server.port: 9001 
management.server.address: 127.0.0.1 


6.4.5 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:9000/hello-world， 结 果 如 图 6-8 所 示 。 在 浏览 


器 中 输入 localhost:9001/actuator/health， 结 果 显 示 已 经 启动 监控 (状态 为 UP)， 如 图 6-9 所 示 。 


/ 24 localhost:9000/hello-w x V 


c C | © localhost:9000/hello-world 


l'id':1l,"content':"Hello, Stranger! "| 


图 6-8 在 浏览 器 中 输入 localhost:9000/hello-world 的 结果 
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/ [1 localhost:9001/actuatc X \ \ 


€ C ] © localhost:9001 /actuator/health 


['status" :"UP"] 


图 6-9 在 浏览 器 中 输入 localhost:9001/actuator/health 的 结果 


6.5 ”实现 跨 域 资源 共享 的 RESTful 风格 Web 服务 


通过 XMLHttpRequest (XHR) 实现 Ajax 通信 时 一 个 主要 限制 就 是 足 l 
域 问 题 。 默 认 情 况 下 ，XHR 对 象 只 能 访问 与 包含 它 的 页 和 面 位 于 同一 个 域 中 视频 讲解 
的 资源 。 路 域 资源 共享 CCross-Origin Resource Sharing; CORS) 解决 了 Ajax 路 域 的 问题 。 
跨 域 资源 共享 是 一 种 网 络 浏览 吉 的 技术 规范 , 它 为 Web 服务 器 定义 了 一 种 方式 ， 人 允许 网 页 
从 不 同 的 域 访问 其 资源 。 骂 域 资源 共享 定义 了 在 必须 访问 路 域 资 源 时 ， 浏 览 嚣 与 服务 需 该 
如 何 沟通 。 其 背后 的 基本 思想 是 使 用 目 定 义 的 HITP 头 部 ， 让 浏览 喜与 服务 喜 进 行 沟通 ， 
从 而 决定 请 求 或 啊 应 是 应 该 成 功 还 是 应 该 失败 。 实 现 此 功能 非 币 简单 ， 只 需 由 服务 器 发 送 
一 个 啊 应 确认 即 可 。 


6.5.4 ”添加 依赖 


在 pom.xml 文件 中 <dependencles> 和 </dependencles> 之 间 添 加 对 Web 的 依赖 ， 具 体 代 
huit Z2; 6.4.1 节 例 6-12 中 第 二 对 <dependency> 和 </dependency> 之 间 的 内 容 。 


6.5.20 ”创建 类 CORSConfiguration 


在 包 com.bookcode.config 中 创建 类 CORSConfiguration， 代 人 码 如 例 6-16 所 示 。 
【 例 6-16】 创建 类 CORSConfiguration 的 代码 示例 。 


package com.bookcode.config; 
import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.web.servlet.config.annotation.CorsRegistry; 
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; 
import org.springframework.web.servlet.config.annotation. 
WebMvcConfigurerAdapter; 
QGConfiguration 
public class CORSConfiguration ( 

QBean 

public WebMvcConfigurer corsConfigurer() ( 

return new WebMvcConfigurerAdapter() { 


public void addCorsMappings (CorsRegistry registry) ( 
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registry.addMapping ("/api/**").allowedOrigins ("http:// 
1217.0.0. 1: BUB) 4 


6.5.3 创建 类 ApiController 


在 com.bookcode.controller 包 中 创建 类 ApiController， 代 码 如 例 6-17 所 示 。 
【 例 6-17] 创建 类 ApiController 的 代码 示例 。 


package com.bookcode.controller; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestParam; 
import org.springframework.web.bind.annotation.RestController; 
import java.util.HashMap; 
QGRestController 
public class ApiController( 
QGRequestMapping (value = "/get") 
public HashMap«String, Object» get(GRequestParam (value-"name",required- 
false,defaultValue-"jK-—") String name) 
{ 
HashMap«String, Object» hashMap = new HashMap«cString, Object»(); 
hashMap.put("title", "CORS Test"); 
hashMap.put("name", name); 
return hashMap; 
) 


6.5.4 创建 文件 CORSjs.html 


在 resources/staüc 目录 下 创建 文件 CORSjs.html, [Vno] 6-18 所 示 。 
【 例 6-18】 创建 文件 CORSjs.html 的 代 人 码 示例 。 


«!DOCTYPE html» 
«html» 
«head» 
«meta charset-"UTF-8"/» 
<title> 使 用 coRS«/title» 
<script> 
function refreshPrice(data)( 
var p-document.getElementById('test-jsonp'); 
p.innerHTML=' 当前 价格 : "+ 
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data['0000001'].name-':'-« 
data['0000001'].price-';'-« 
data['1399001'].name-':'-« 
data['1399001'].price; 

} 

function getPrice()í( 


— < 


var js-document.createElement('script'); 
head-document.getElementsByTagName ('head') [0]; 
// 问 路 域 网 站 发 送 请 求 资 源 ， 并 在 得 到 资源 后 调用 refreshPrice K% 
js.src-'http://api.money.126.net/data/feed/0000001,1399001? 
callback-refreshPrice'; 
head.append(js); 
} 
«/script» 
</head> 
<body> 
<div> 
<p>CORS 应 用 一 一 以 163 的 股票 查询 URL XH], URL X http://api.money.126.net</p> 
«button type-"button" onclick-"getPrice () "2A r«/button» 
«p id-"test-jsonp"»«/p» 
«/div» 
«/body» 
«/html» 


6.5.5 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/get， 结 果 如 图 6-10 所 示 。 在 浏览 器 中 输 
入 localhost:8080/get?name-9627 李斯 %27， 结 果 如 图 6-11 所 示 。 在 浏览 妖 中 输入 localhost: 
8080/CORSjs.html 并 单 击 “刷新 ”按钮 ， 结 果 如 图 6-12 所 示 。 


y 2x localhost:8080/get 


€ E | © localhost:8080/get 


Iname”: 3k”, "title": "CORS Test"] 


图 6-10 在 浏览 器 中 输入 localhost:8080/get 的 结果 


y Ø localhost:8080/get?na: X 


€ C | © localhost:8080/get?name=9%27 李 斯 %27 


{"name” :” 李斯 **, "title": "CORS Test"] 


图 6-11 在 浏览 器 中 输入 localhost:8080/get?name=%27 李斯 %27 的 结果 
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Œ | © localhost:8080/CORSjs.html 


CORS 应 用 一 一 以 163 的 股票 查询 URL 为 例 ， 对 于 URL: http://api.money.126.net 


当前 价格 : 上 证 指数 :2561.61: 深 证 成 指 :7365.209 


图 6-12 ”在 浏览 器 中 输入 localhost:8080/CORSjs.html 
并 单 击 “ 刷 新 ”按钮 后 的 结果 


6.6 ”实现 超 媒 体 驱 动 的 RESTful 风格 Web 服务 


客户 端 和 服务 器 解 灰 并 独立 演化 的 服务 。 为 RESI 资源 返回 的 表达 
(Representations) 不 仅 包 含 数据 ， 还 包含 相关 资源 的 链接 。 因 此 ， 表 达 的 设 
计 对 于 整个 服务 的 设计 至 关 重 要 。 

Richardson 提出 的 REST 成 熟 度 模型 把 REST 服务 按照 成 熟 度 划分 成 四 个 层次 : 第 
一 个 层次 Web 服务 只 是 使 用 HTTP 作为 传输 方式 ， 实 际 上 只 是 远程 方法 调用 (RPC) 的 
一 种 具体 形式 ，SOAP 和 XML-RPC 都 属于 此 类 ; 第 二 个 层次 Web 服务 引入 了 资源 的 概 
念 ， 每 个 资源 有 对 应 的 标识 符 和 表达 ; 第 三 个 层次 Web 服务 使 用 不 同 的 HTTP 方法 来 进 
行 不 同 操作 ,并 且 使 用 HTTP 状态 人 码 来 表示 不 同 结 果 ， 如 用 HTTP GET 方法 来 获取 资源 、 
用 HTTP DELETE 方法 来 删除 资源 ; 第 四 个 层次 Web 服务 使 用 HATEOAS (Hypermedia 
As The Engine Of Application State )， 在 资源 的 表达 中 包含 了 链接 信息 ， 客 户 端 可 以 根据 链 
接 来 发 现 可 以 执行 的 动作 。 

从 Richardson. 提出 的 模型 中 可 以 看 到 ， 使 用 HATEOAS 的 REST 服务 成 熟 度 最 高 ， 
也 是 推荐 的 做 法 。 它 的 重要 性 在 于 打破 了 客户 端 和 服务 器 之 间 严 格 的 契约 ， 使 得 客户 端 可 
以 更 加 智能 和 目 适应 ， 而 REST 服务 本 身 的 演化 和 更 新 也 变 得 更 加 容易 。 对 于 不 使 用 
HATEOAS 的 REST 服务 , 客户 端 和 服务 器 的 实现 之 间 紧 密 耦 合 。 客 户 端 需要 根据 服务 器 
提供 的 相关 文档 来 了 解 所 暴露 的 资源 和 对 应 的 操作 。 当 服务 器 发 生 了 变化 时 ， 如 修改 了 资 
源 URI， 客 户 端 也 需要 进行 相应 的 修改 。 而 使 用 HATEOAS 的 REST 服务 中 ， 则 客户 端 
可 以 通过 服务 器 提供 的 资源 表达 来 智能 地 发 现 可 以 执行 的 操作 。 若 服务 器 发 生 了 变化 ， 则 
客户 端 不 需要 修改 ， 因 为 资源 的 URI 和 其 他 信息 都 是 动态 发 现 的 。 


视频 讲解 


6.6.1 ”添加 依赖 


在 pom.xml 文件 中 <dependencles> 和 </dependencles> 之 间 添 加 Web、HATEOAS 和 
Jackson Sfi, (Vh anh] 6-19 所 示 。 

【 例 6-19】 添加 Web, HATEOAS 和 Jackson 等 依赖 的 代码 示例 。 

«dependency» 


«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 
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</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-hateoas«/artifactId» 

</dependency> $ 

<dependency> t 
«groupId»com.fasterxml.jackson.core«/groupId» 
«artifactId»jackson-annotations«/artifactId» 
«version»2.9.0«/version» 


«/dependency» 


6.6.2 GIH Greet 


在 包 com.bookcode.entity FEJE Greet, RE in] 6-20 所 示 。 
【 例 6-20] 创建 类 Greet 的 代码 示例 。 


package com.bookcode.entity; 
import com.fasterxml.jackson.annotation.JsonCreator; 
import com.fasterxml.jackson.annotation.JsonProperty; 
import org.springframework.hateoas.ResourceSupport; 
public class Greet extends ResourceSupport { 

private final String content; 

QJsonCreator 

public Greet (@JsonProperty ("content") String content) { 

this.content = content; 
} 
public String getContent() { 


return content} 


6.6.3 ”创建 类 GreetController 


在 com.bookcode.controller 包 中 创建 类 GreetController， 代 码 如 例 6-21 所 示 。 
【 例 6-21] 创建 类 GreetController 的 代码 示例 。 


package com.bookcode.controller; 

import static org.springframework.hateoas.mvc.ControllerLinkBuilder.*; 
import com.bookcode.entity.Greet; 

import org.springframework.http.HttpEntity; 

import org.springframework.http.HttpStatus; 

import org.springframework.http.ResponseEntity; 

import org.springframework.web.bind.annotation.RestController; 


import org.springframework.web.bind.annotation.RequestMapping; 
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import org.springframework.web.bind.annotation.RequestParam; 


QGRestController 
public class GreetController { 
private static final String TEMPLATE - "Hello, $s!"; 
$ QRequestMapping ("/greet") 
t public HttpEntity«Greet» greet ( 


@RequestParam (value = "name", required = false, defaultValue = "World") 
String name) { 

Greet greet = new Greet (String.format (TEMPLATE, name)); 

greet .add (linkTo (methodOn (GreetController.class).greet (name)). 
withSelfRel()): 

return new ResponseEntity«»(greet, HttpStatus.OK); 


6.6.4 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/greet， 结 果 如 图 6-13 所 示 。 在 浏览 器 中 
输入 localhost:8080/greeting?namezhangsan， 结 果 如 图 6-14 所 示 。 


/ Sg localhost:8080/greet X V 


-— CQ | © localhost:8080/greet 


l'content":"Hello, World!"," links": {" self”: l'href": "http: //localhost:98080/zreet?name-World"]]] 


图 6-13 ”在 浏览 器 中 输入 localhost:8080/greet 的 结果 


/ Ø localhost:8080/greetin: X V 


€ C | © localhost:8080/greeting?name-zhangsan 


l'id':2,'content' :" Hello, zhanzsan! | 


图 6-14 在 浏览 器 中 输入 localhost:8080/greeting?name-zhangsan 的 结果 


6.7 RS CXF 的 Web 服务 开发 


Apache CXF = Celtix + XFire， 开 始 叫 Apache CeltiXfire， 后 来 更 名 为 
Apache CXF. Apache CXF 是 一 个 开源 的 Services 框架 。CXF 支持 多 种 视频 讲解 
Web Services 标准 ， 包 含 SOAP, Basic Profile, WS-Addressing 、 WS-Policy 、 
WS-ReliableMessaging 和 WS-Security. 


SOAP (Simple Object Access Protocol， 人 简单 对 象 访问 协议 ) 是 交换 数据 的 一 种 协议 规 
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范 ， 是 一 种 简单 、 轻 量 、 基 于 XML 的 协议 ， 它 被 设计 成 在 Web 上 交换 结构 化 和 固化 的 信 
A. SOAP 和 Web 服务 描述 语言 (Web Services Description Language, WSDL) 以 及 通用 
描述 、 发 现 与 集成 服务 (Universal Description Discovery and Integration, UDDI) 是 实现 
Web 服务 的 关键 。SOAP 用 来 描述 传递 信息 的 格式 ;， WSDL 用 来 描述 如 何 访问 具体 的 接口 ; 
UDDI HKE, JE Aw Web 服务 。 ' 


6.7.1 修改 文件 pom.xml 


pom.xml 文件 代码 如 例 6-22 所 示 。 
【 例 6-22】 pom.xml 文件 的 代码 示例 。 


«?xml version-"1.0" encoding-"UTF-8"?» 

«project xmlns-"http://maven.apache.org/POM/4.0.0" xmlns:xsi-"http://www. 

w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 http: 
//maven.apache.org/xsd/maven-4.0.0.xsd"» 

«modelVersion»4.0.0«/modelVersion» 

«groupId»com.dbgoc/groupId» 

«artifactId»webservicedemo«/artifactId» 

«version»0.0.1-SNAPSHOT«/version» 

«packaging»jar«c«/packaging» 

«name»webservicedemo«/name» 

«description»Demo project for Spring Boot«/description» 

«parent» 

«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-parent«/artifactId» 
«version»1.5.8.RELEASE«/version» 

«relativePath/» «!-- lookup parent from repository --» 

«/parent» 

«properties» 
Xproject.build.sourceEncoding»UTF-8«/project.build.sourceEncoding» 
«project.reporting.outputEncoding»UTF-8«/project.reporting. 
outputEncoding» 

«java.version»1.8«/java.version» 

«/properties» 

«dependencies» 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 

</dependency> 

«!--WebService CXF 依赖 --> 

<dependency> 
«grouplId»org.apache.cxf«/groupId» 
«artifactId»cxf-rt-frontend-jaxws«/artifactId» 
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6.7. ”创建 类 User 


在 com.bookcode.entity 中 创建 类 User, fV no] 6-23 所 示 。 
【 例 6-23】 创建 类 User 的 代码 示例 。 
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6.7.3 创建 接口 UserService 


在 包 com.bookcode.dao 中 创建 接口 UserService， 代 人 码 如 例 6-24 所 示 。 
【 例 6-24】 创建 接口 UserService 的 代码 示例 。 
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0.7.4 


创建 类 UserServiceImpl 


在 com.bookcode.dao 包 中 创建 类 UserServiceImpl， 代 人 码 如 例 6-25 所 示 。 
【 例 6-25] 创建 类 UserServiceImpl 的 代码 示例 。 


package com.bookcode.dao; 


import 
import 
import 
import 
import 


com.bookcode.entity.User; 
java.util.Date; 
java.util.HashMap; 
java.util.Map; 
javax.jws.WebService; 


QWebService (targetNamespace-"http://dao.bookcode.com/",endpointInterface- 


"Com.bookcode.dao.UserService") 


public 


class UserServiceImpl implements UserService( 


private Map«String, User» userMap = new HashMap«String, User»(); 


public UserServiceImpl() ( 


} 


System.out .println(" 回 实体 类 插入 数据 ") ; 
User user = new User(); 
user.setUserId("411001"); 
user.setUsername ("zhansan") ; 
user.setAge ("20"); 
user.setUpdateTime (new Date()); 
userMap.put(user.getUserId(), user); 
user = new User(); 

user.setUserId ("411002"); 
user.setUsername ("lisi"); 
user.setAge ("30"); 
user.setUpdateTime (new Date()); 
userMap.put (user.getUserid(), user); 
user - new User(); 
user.setUserId("411003"); 
user.setUsername ("wangwu"); 
user.setAge ("40"); 
user.setUpdateTime (new Date()); 


userMap.put(user.getUserId(), user); 


QGOverride 


public String getName (String userId) { 


} 


return "liyd-" + userId; 


QOverride 


public User getUser (String userId) ( 


System.out.println ("userMap 是:"+userMap); 


return userMap.get (userId); 
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6.7.5 创建 类 TestConfig 


在 包 com.bookcode.config 中 创建 类 TestConfig， 代 人 码 如 例 6-26 所 示 。 
【 例 6-26】 创建 类 TestConfig 的 代码 示例 。 


package com.bookcode.config; ' 
import javax.xml.ws.Endpoint; 
import com.bookcode.dao.UserService; 
import com.bookcode.dao.UserServiceImpl; 
import org.apache.cxf.Bus; 
import org.apache.cxf.bus.spring.SpringBus; 
import org.apache.cxf.jaxws.EndpointImpl; 
import org.apache.cxf.transport.servlet.CXFServlet; 
import org.springframework.boot.web.servlet.ServletRegistrationBean; 
import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 
QGConfiguration 
public class TestConfig { 
QBean 
public ServletRegistrationBean dispatcherServlet() ( 
return new ServletRegistrationBean(new CXFServlet(), "/test/*"); 
} 
@Bean (name = Bus.DEFAULT BUS ID) 
public SpringBus springBus() ( 
return new SpringBus(); 
} 
@Bean 
public UserService userService() { 
return new UserServiceImpl(); 
} 
QBean 
public Endpoint endpoint() { 
EndpointImpl endpoint = new EndpointImpl(springBus(), userService()); 
endpoint.publish("/user"); 


return endpoint; 


6.7.6 ”运行 程序 


至 此 服务 器 开发 完成 。 运 行程 序 后 ， 在 浏览 器 中 输入 localhost:8080/test/user?wsdl, £i 
果 如 图 6-15 所 示 。 
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(ONocalhost:8080/test/user?wsd| 


This XML file does not appear to have any style information associated with it. The document tree is shown below. 


v 4vsdl: definitions zmlns: xzd-7 bhtip://ww.w. org/2001/XMLSchema  xminz: vsdl- http: //schenas.xnlscap.orz/wsdl/" xmlns tne htitip://dao. bookcode.con/" xnlre .scap™ http: // schemaz. mlsonc. orz/vsdl/sozp/ " 
znlrs nzl- http: //schenasz.znlzoap.org/zoap/http'  nane- UserServicelmplSorwics" cargetlíanszpacc- http: //dao. booxcods. com > 
v cusdl:twpez^ 
vsxs:schema xmlns: xs-"http:/ l'a. w3. orgé 2001/XW.Senena^ xnlns:tns-^"http: /rdan. bookcade. cons” elenentForiDefauli-"ungualified" targetWanespac e-"http: // dao. bookeode. can" versions" 1. 0" 
(xs:elenent name=” getName” type=” tns: getNane" /> 
(xs:elenent Danc gctJameResponse”type= tns: getNanceRezpocze" /Y 
$ (xs:clenent nome™ gctUscr” type™ ins: zetÜser" /) 
<ua: elenent name= getUserRezponze' typo- tns: cetUÜUserResporze'/2 
E Y xz:complexType nane=” getName > 
Y <x: sequenc e> 
(xs: element niccurs=" 0" name= "userId" typee"xs strire’/y 
Xxs: se pence) 
(xs: conp lex Type? 
v Sua: compleæe Typa name=“ getNareResponss” > 
"Y cxe: Sequence> 
¿xs elenent nincours="0 name= "return" type="xs: strirg'/; 
ixa: segience» 
{lixs conplexType? 
v xs: complex Typs hamc gctÜser^? 
"Y <x: sequence a> 
ixs:element nin)jccurs- 0 name= "arg" type= xs:string /5 
C/xz: segaenca? 
¿ixe conplexType» 
Y xs: complex Typs name getUserRespons-* 
Y Áxs: sequence? 
ixz:elenent ninüccars- (^ name=” return type-"tns:user /> 
4/x3: seqana? 
Cfx2: conplexType» 
v xs: complexType nane user "> 
Y Wxs: sequence» 
(xs;elenent ninj)ccurz-"Ü" name-"age" type xs:sicing /? 
(xs: clenent ninüccurz- 0" name- updatelime^ type7^7xs: dateline"/? 
ixz:element ninüccurz- 0" nzme-"userld' type-'zz: string /7^ 
C/xs: segience? 
Cfxs conplexType» 
&/xs: schena? 
Cwsdl: types 
v &wsdl:messagze nance7"gcetlane"? 
4£wedl:part elenent- tns:getlame' none-"parzmetors ^ 4/wsdl: part? 
Chwedl: nezzage^ 


图 6-15 在 浏览 器 中 输入 localhost:8080/test/user?wsdl 的 结果 


6.7.7 ”创建 类 Client 并 运行 程序 


在 包 com.bookcode.client 中 创建 类 Client， 代码 如 例 6-27 所 示 。 
【 例 6-27】 创建 类 Client 的 代 人 码 示例 。 


package com.bookcode.client; 
import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory; 
public class Client 1{ 
public static void main(String args[]) throws Exception( 
JaxWsDynamicClientFactory dcf -JaxWsDynamicClientFactory.newInstance(); 
org.apache.cxf.endpoint.Client client -dcf.createClient ("http:// 
localhost:8080/test/user?wsdl"); 
//getUser 为 接口 中 定义 的 方法 名 称 ， 张 三 为 传递 的 参数 ， 返 回 一 个 Object 数组 
Object [] objects-client.invoke ("getUser","411001"); 


// 输 出 调用 结果 
System.out.println ("*****"+objects[0] .tostring()+" 张 三 ， 你 好 ! "); 


一 一 


运行 Client 类 后 ， 控 制 台 中 的 输出 结果 如 图 6-16 所 示 。 


xXoelelekcom. bookcode. dao. User@4d9d1b69 张 三 ， 你 好 ! 


图 6-16 运行 Client 后 控制 台中 的 输出 结果 
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2]; 6 


简 答 题 

l. 简 述 对 Web 服务 的 理解 。 

2. 简 述 对 Actuator 的 理解 。 

3. 傈 述 对 跨 域 资源 共享 的 理解 。 
4 

5 


< < 


， 简 述 对 超 媒体 驱动 和 HATEOAS 的 理解 。 
. 简 述 对 SOAP 的 理解 。 
， 基 于 Jersey 实现 RESTful 风格 Web 服务 。 
. 实现 对 RESTful 风格 Web 服务 的 使 用 。 
， 实 现 对 带 Angular 的 RESTful 风格 Web 服务 的 使 用 。 
基于 Actuator 实现 RESTful 风格 Web 服务 。 
.实现 跨 域 资源 共享 的 RESTful 风格 Web 服务 的 使 用 。 
， 实 现 超 媒 体 驱 动 的 RESTful 风格 Web 服务 。 
.整合 CXF 实现 Web 服务 的 开发 。 


~] A a A 一 


本 章 介绍 如 何 实现 声明 式 事务 、 如 何 实现 数据 缓存 、 如 何 使 用 Druid、 如 何 使 用 表单 
验证 、 如 何 整 合 MyBatis 访问 数据 库 、 如 何 实现 对 Spring Batch 和 Quartz 的 整合 等 内 容 。 


71 声明 式 事务 


Spring 同时 文 持 编程 式 事务 管理 和 声明 式 事务 管理 .对 于 编程 式 事务 管 
JH, Spring 推荐 使 用 TransactionTemplate。 声 明 式 事务 建立 在 AOP 之 上 ， 
其 本 质 是 对 方法 闻 后 进行 拦截 ,然后 在 目标 方法 开始 之 前 创建 或 者 加 入 一 个 
事务 ， 在 执行 完 目 标 方法 之 后 根据 执行 情况 提交 或 者 回 浚 事务 。 声 明 式 事务 承 是 通过 在 配 
置 文件 中 加 声明 的 方式 来 处 理事 务 的 。 声 明 式 事务 最 大 的 优点 束 是 不 需要 在 业务 旬 辑 代码 
中 掺 杂事 务 管理 的 代码 ， 只 要 在 配置 文件 中 做 相关 事务 规则 的 声明 (或 基于 @Transactional 
注解 的 方式 ) 便 可 以 将 事务 规则 应 用 到 业务 馆 辑 中 。Spring 使 用 AOP 来 完成 声明 式 的 事务 
管理 ， 因 而 声明 式 事务 是 以 方法 为 单位 的 。Spring 的 事务 属性 在 于 描述 事务 应 用 至 方法 上 
的 策略 ， 在 Spring 中 事务 属性 有 传播 行为 、 隔 离 级 别 、 只 读 提 示 、 事 务 超时 期 间 四 个 参数 。 
和 编程 式 事务 相 比 ， 声 明 式 事务 的 最 细 粒 度 只 能 作用 到 方法 级 ， 无 法 像 编 程式 事务 那样 可 
以 作用 到 代码 块 级 。 


7.1.1 添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ,代码 如 例 7-1 所 示 。 
【 例 7-1】 添加 依赖 的 代码 示例 。 
«dependency» 

«groupId»org.springframework.boot«/groupId» 
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7.1.2 ”创建 类 Account 


创建 类 Account， 代 码 如 例 7-2 所 示 。 
【 例 7-2】 创建 类 Account 的 代码 示例 。 
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return balance; 
] 
public void setBalance(float balance) { 


Ines Dalane —DJgUBCD 


7.1.3 ”创建 接口 AccountDao 


创建 接口 AccountDao, (Vid ano] 7-3 所 示 。 
【 例 7-3】 创建 接口 AccountDao 的 代码 示例 。 


package com.bookcode.dao; 

import com.bookcode.entity.Account; 

import org.springframework.data.jpa.repository.JpaRepository; 

public interface AccountDao extends JpaRepository«Account, Integer»( 
} 


7.1.4 ”创建 接口 AccountService 


创建 接口 AccountService， 代 码 如 例 7-4 所 示 。 
【 例 7-4】 创建 接口 AccountService 的 代码 示例 。 


package com.bookcode.service; 
public interface AccountService { 


// 从 及 用户 转账 至 boRP,. 4j account 


public void transferAccounts (int fromUser, int toUser, float account); 


7.1.5 创建 类 AccountController 


创建 类 AccountController, fV Ziff] 7-5 所 示 。 
[57-5] 创建 类 AccountController 的 代 公 示例 。 


package com.bookcode.controller; 
import javax.annotation.Resource; 
import com.bookcode.service.AccountService; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 
QGRestController 
QGRequestMapping ("/account") 
public class AccountController ( 
QResource 
private AccountService accoutService; 
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@RequestMapping ("/transfer") 
public String transferAccount () { 
try( 
accoutService.transferAccounts(1, 2, 200); 
return "OK"; à 
} $ 
catch (Exception e){ 


return "NO": 


7.1.6 ”创建 配置 文件 application.yml 


配置 文件 application.yml 的 代码 如 例 7-6 所 示 。 
【 例 7-6】 配置 文件 application.yml 的 代码 示例 。 


spring: 

datasource: 
driver-class-name: com.mysql.jdbc.Driver 
url: jdbc:mysql://localhost:3306/mytest 
username: root 
password: sa 

jpa: 
hibernate: 

ddl-auto: update 

show-sql: true 


7.4.7 创建 类 AccountServiceImpl 


创建 类 AccountServiceImpl， 代 人 码 如 例 7-7 所 示 。 
【 例 7-7】 创建 类 AccountServiceImpl 的 代码 示例 。 


package com.bookcode.service.impl; 
import javax.annotation.Resource; 
import javax.transaction.Transactional; 
import com.bookcode.dao.AccountDao; 
import com.bookcode.entity.Account; 
import com.bookcode.service.AccountService; 
import org.springframework.stereotype.Service; 
QService("accountService") 
public class AccountServiceImpl implements AccountService { 
QResource 
private AccountDao accountDao; 


Transactional 


142, — Spring Boot 开发 实战 一 一 微 课 视频 版 


public void transferAccounts (int fromUser, int toUser, float account) { 
Account fromAccount-accountDao.getOne (fromUser); 
fromAccount.setBalance(fromAccount.getBalance ()-account); 
accountDao.save(fromAccount); 
$ Account toAccount-accountDao.getOne (toUser); 
t toAccount.setBalance (toAccount .getBalance ()+account) ; 
int zero=1/0; 


accountDao.save(toAccount); 


7.1.8 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/accounttransfer， 转 账 操 作出 现 异 背 ， 在 
浏览 器 中 输出 NO， 结 果 如 网 7-1 所 示 。 此 时 的 数据 库 表 account 不 会 发 生变 化 ， 原 始 数 据 
在 工具 Navcat for MySQL 中 的 结果 如 图 7-2 所 示 。 对 例 7-7 代码 中 语句 “int zero=1/0:” 添 
加 注释 后 ， 重 新 运行 程序 ， 在 浏览 器 中 输入 localhost:8080/account/transfer， 完 成 正常 的 转 
账 ， 浏 览 右 输出 OK， 结 果 如 图 7-3 所 示 。 与 此 同时 ， 数 据 库 表 account 中 第 1 条 记录 〈 张 
三 )、 第 2 条 记录 ( 李 四 ) 的 账户 balance 分 别 减少 、 增 加 200, 数据 库 最 新 数据 在 工具 Navicat 
for MySQL 中 的 结果 如 图 7-4 所 示 。 对 例 7-7 代 人 码 中 注解 @Transactional 添加 注释 且 去 反对 
语句 “int zero-1/0; ”的 注释 后 ， 午 新 运行 程序 ， 在 浏览 器 中 输入 
localhost:8080/account/transfer， 转 账 操作 出 现 异 常 ， 浏 览 器 输出 NO， 结果 如 图 7-1 所 示 。 
与 此 同时 ， 数 据 库 表 account 中 第 1 条 记录 〈 张 三) 的 账户 balance 减少 了 200， 但 是 第 2 
条 记录 (〈 李 四 ) 的 账户 balance 没有 发 生变 化 , 转账 操作 出 现 异 常 时 数据 变动 在 工具 Navcat 
for MySQL 中 的 结果 如 图 7-5 所 示 。 


/ S localhost:8080/accoun: X ^ 


€ C | © localhost:8080/account/transfer 


NO 


图 7-1 在 浏览 器 中 输入 localhost:8080/account/transfer 的 结果 
(由 于 执行 “1 除 0” 而 输出 NO) 
F t account @mytest (mysql) - Æ 
文件 gua EEE m 帮助 
国 ; 导入 向 导 BSHS Y 第 选 向 导 HB 


balance user name 


90000 3K— 
10200 李 四 
25000 王 五 


图 7-2 原始 数据 在 工具 Navicat for MySQL 中 的 结果 
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/ @ localhost:8080/accoun: X IN! 


€ C © localhost:8080/account/transfer 


OK 


— D 


图 7-3 完成 正常 转账 后 的 输出 


F” t account @mytest (mysql) - 表 
文件 Sm EA BD 帮助 
E 导入 向 导 国 导出 向 导 Y eras 
balance user name 
89800 张 二 
10400 李 四 
25000 Th 


F” t account Gmytest (mysql) - Æ 
文件 ”编辑 查看 窗口 帮助 
Esse 国 导 出 向 导 Y wee E 


id balance user name 
1 aN—L L- 
2 10400 李 四 
3 25000 Th 


图 7-5 FEIRER BIE E NE AUS EZ) TE LH. Navicat for MySQL 中 的 结果 


72 ”数据 缓存 


在 实际 开发 中 ， 对 于 要 反复 谈 写 的 数据 ， 好 的 处 理 方式 是 将 之 在 内 存 J 
中 缓存 一 份 。Spring 在 数据 缓存 方面 提供 了 许多 处 理 手 段 ，Spring Boot 又 ”视频 讲解 
将 方式 进一步 简化 。Spring 在 org.springframework.cache 包 中 定义 了 
CacheManager 和 Cache 两 个 接口 来 统一 不 同 的 缓存 技术 。 其 中 ，CacheManager 是 Spring 
提供 的 各 种 缓存 技术 抽象 接口 ，Cache 接口 包含 缓存 的 各 种 操作 (增加 、 删 除 、 获 得 缓存 )。 
针对 不 同 的 缓存 技术 ， 需 要 实现 不 同 的 CacheManager，Spring 定义 了 如 下 CacheManager 
来 实现 。 

(1) SimpleCacheManager: 使 用 简单 的 Collection 来 存储 缓存 ， 主 要 用 来 测试 用 途 。 

(2) ConcurrentMapCacheManager: 使 用 ConcurrentMap 来 存储 绥 存 。 
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(3) NoOpCacheManager: 仅 用 于 测试 ， 不 会 实际 存储 绥 存 。 

(4) EhCacheCacheManger: 使 用 EhCache 作为 缓存 技术 。 

(5) GuavaCacheManager: 使 用 Google Guava 的 GuavaCache 作为 缓存 技术 。 

(6) RedisCacheManager: 使 用 Redis 作为 缓存 技术 。 

在 Spring 中 使 用 绥 存 技术 的 关键 是 配置 CacheManager, Spring Boot 自动 配置 了 多 个 
CacheManager 来 实现 。Spring Boot 的 CacheManager 目 动 配置 放置 在 org.springframework. 
boot.autoconfigure.cache 包 中 ， 默 认 使 用 的 CacheManager 是 SimpleCacheConfiguration (EJ 
ConcurrentMapCacheManager)。Spring Boot 支持 以 spring.cache 为 前 级 的 属性 来 配置 缓存 。 
使 用 缓存 技术 只 需 在 项 目 中 添加 依赖 , 并 在 配置 类 中 使 用 注解 @EnableCaching 开启 缓存 文 
持 即 可 。 


7.2.1 ”添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ,代码 如 例 7-8 所 示 。 
【 例 7-8】 添加 依赖 的 代码 示 例 。 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 
</dependency> 
<dependency> 
<groupId>javax.persistence</groupId> 
<artifactId>persistence-api</artifactId> 
«version»1.0«/version» 
</dependency> 
<dependency> 
<groupId>mysql</groupId> 
«artifactId»mysql-connector-java«/artifactId» 
</dependency> 
<dependency> 
<groupId>org.springframework.boot</groupId> 
«artifactId»spring-boot-starter-data-jpa«/artifactId» 
«/dependency» 


7.2.2 ”创建 类 DemolInfo 


创建 类 DemoInfo， 代 码 如 例 7-9 所 示 。 
【 例 7-9】 创建 类 Demolnfo 的 代码 示例 。 


package com.bookcode.entity; 
import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 


import javax.persistence.Id; 
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7.2.3 创建 接口 DemoInfoRepository 


创建 接口 DemoInfoRepository， 代 码 如 例 7-10 所 示 。 
【 例 7-10】 创建 接口 DemoInfoRepository 的 代码 示例 。 
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import com.bookcode.entity.DemoInfo; 

import org.springframework.data.repository.CrudRepository; 

public interface DemoInfoRepository extends CrudRepository«DemoInfo,Long» ( 
} 


7.2.4 创建 接口 DemolnfoService 


创建 接口 DemoInfoService， 代 码 如 例 7-11 所 示 。 
【 例 7-11】 创建 接口 DemolInfoService 的 代码 示例 。 


package com.bookcode.service; 
import com.bookcode.entity.DemoInfo; 
import javassist.NotFoundException; 
import java.util.Optional; 
public interface DemoInfoService ( 
void delete(Long id); 
DemoInfo update (DemoInfo updated) throws NotFoundException; 
Optional«DemoInfo» findById(Long id); 
DemoInfo save(DemoInfo demoInfo); 


7.3.5 创建 类 DemolnfoServiceImpl 


创建 类 DemolInfoServicelmpl, RE tni] 7-12 所 示 。 
【 例 7-12】 创建 类 DemolnfoServiceImpl 的 代码 示例 。 


package com.bookcode.service.impl; 

import com.bookcode.dao.DemoInfoRepository; 

import com.bookcode.entity.DemoInfo; 

import com.bookcode.service.DemoInfoService; 

import javassist.NotFoundException; 

import org.springframework.cache.annotation.CacheEvict; 

import org.springframework.cache.annotation.CachePut; 

import org.springframework.cache.annotation.Cacheable; 

import org.springframework.stereotype.Service; 

import javax.annotation.Resource; 

import java.util.Optional; 

QService 

public class DemoInfoServicelImpl implements DemoInfoService { 
// 这 里 的 单 引 号 不 能 少 ， 和 否则 会 报错 ， 被 识别 的 是 一 个 对 象 
public static final String CACHE KEY - "'demoInfo'"; 
QGResource 
private DemoInfoRepository demoInfoRepository; 
public static final String DEMO CACHE NAME - "demo"; 
QCacheEvict(value-DEMO CACHE NAME,key-CACHE KEY) 
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QOverride 
public DemoInfo save(DemoInfo demoInfo)(|( 
return demoInfoRepository.save ((demoInfo); 
} 
QGCacheable (Value=DEMO CACHE NAME,key-"'demoInfo '-«£id") $ 
QOverride 
public Optional«DemoInfo» findById(Long id)( 
System.-err.println(" 没 有 走 缓 存 ! "+id) ; 
return demoInfoRepository.findById(id); 
} 
@CachePut (value = DEMO CACHE NAME, key = "'demoInfo '+#updated.getId()") 
QOverride 
public DemoInfo update (DemoInfo updated) throws NotFoundException { 
Optional«DemoInfo» opdemoInfo = demoInfoRepository.findById 
(updated.getId()); 
if(opdemoInfo == null)( 
throw new NotFoundException ("No find"); 
} 
DemoInfo demoInfo; 
opdemoInfo.getí().setName (updated.getName ()); 
opdemoInfo.get().setPwd(updated.getPwd()); 
demoInfo-opdemoInfo.get(); 
return demoInfo; 


} 
@CacheEvict (value = DEMO CACHE NAME, key = "'demoInfo '-4£id") 


QOverride 
public void delete (Long id) ( 
System.out .println ("模拟 删除 : "+id); 


7.2.6 ”创建 类 DemolInfoController 


创建 类 DemoIfoController， 代 码 如 例 7-13 所 示 。 
【 例 7-13】 创建 类 DemoInfoController 的 代码 示例 。 


package com.bookcode.controller; 

import com.bookcode.entity.DemoInfo; 

import com.bookcode.service.DemoInfoService; 

import javassist.NotFoundException; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 
import javax.annotation.Resource; 

QGRestController 

public class DemoInfoController { 
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QResource 
private DemoInfoService demoInfoService; 
QRequestMapping ("/test") 
public String test() ( 
A // 存 入 两 条 数据 
t DemoInfo demoInfo = new DemoInfo(); 
demoInfo.setName ("3k —"); 
demoInfo.setPwd ("123456"); 
DemoInfo demoInfo2 = demoInfoService.save (demoInfo); 
[IDEE 
System.out.println (demoInfoService.findById (demoInfo2.getId())); 
// 走 缓存 
System.out.println (demoInfoService.findById (demoInfo2.getId(())); 
demoInfo = new DemoInfo(); 
demoInfo.setName (" 李 四 ") ; 
demoInfo.setPwd ("123456"); 


DemoInfo demoInfo3 = demoInfoService.save (demoInfo); 


// 不 走 缓存 

System.out.println (demoInfoService.findById (demoInfo3.getId())); 
// 走 缓存 

System.out.println(demoInfoService.findById (demoInfo3.getId())):; 
System. out .println ("============ 修 改 数据 =====================")，} 
// 修 改 数 据 


DemoInfo updated = new DemoInfo(); 
updated.setName (" 李 四 -updated") ; 
updated.setPwd("123456"); 
updated.setId(demoInfo3.getId()); 
try E | 
System.out.println (demoInfoService.update (updated) ) ; 
} 
catch (NotFoundException e) { 
e.printStackTrace(); 
} 
// 不 走 缓存 
System.out.println (demoInfoService.findById (updated.getId ())); 
//System.out.println (demoInfoService.findById (updated.getId())); 


return "ok": 


7.27 ”创建 配置 文件 后 运行 程序 


创建 配置 文件 application.yml， 代 码 如 例 7-6 所 示 。 
运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/test， 在 浏览 器 中 输出 ok， 结 果 如 图 7-6 
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所 示 ; 同时 ， 在 控制 台中 的 输出 结果 如 图 7-7 Pra. 


/ \ | 
/ © localhost:8080/test X WD 


€ > Q |O localhost:8080/test 


图 7-6 在 浏览 器 中 输入 ocalhost:8080/test 后 输出 ok 


Hibernate: select 
Hibernate: update 
Hibernate: insert 
汉 有 走 绥 存 ! 3 

Optional [DemoInfo 
Optional [DemoInfo 
Hibernate: select 
Hibernate: update 
HAEE! 4 

Hibernate: insert 
Optional[DemoInfo 
Optional[DemoInfo 


next val as id val from hibernate sequence for update 


hibernate sequence set next val- ? where next val-? 


into demo info (name, pwd, state, id) values (?, ?, ?, 


[id-3, name-3K =, pwd-123456, state-null]] 
[id-3, name-3K =, pwd-123456, state-null]] 
next val as id val from hibernate sequence for update 


hibernate sequence set next val- ? where next val-? 


into demo info (name, pwd, state, id) values (?, ?, ?, 


[id-4, name-4*[|, pwd-123456, state-nullll 
[id-4, name=# fU, pwd-123456, state-null]] 


DemoInfo [id-4, name-^k[-updated, pwd-123456, state-null] 


Optional[DemoInfo 


7.3 使 用 Druid 


[id=4，name= 李 四 -updated，pwd=123456，state=nul1jj 


图 7-7 在 控制 台中 的 输出 结果 


Druid 是 阿里 巴巴 开发 的 号 称 为 监控 而 生 的 数据 库 连 接 池 ， 它 在 功能 、 
性 能 、 扩 展 性 方面 都 超过 其 他 数据 库 连 接 池 (如 DBCP、C3P0、BoneCP、 
Proxool, JBoss DataSource 等 )。Druid 已 经 在 阿里 巴巴 部 署 了 许多 应 用 ， 经 
过 了 生产 环境 大 规模 部 署 的 严 奇 考验 。Druid 不 仅仅 是 一 个 数据 库 连 接 池 ， 
括 监控 和 详细 统计 数据 库 访 问 性 能 ， 对 数据 库 密 但 进行 加 密 ， 提 供 不 同 的 LogFilter〈 文 持 
Common-Logging. Log4j 和 JdkLog 等 )， 文 持 编写 JDBC 层 的 扩展 插件 。 


7.3.1 添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ， 代 码 如 例 7-14 


所 示 。 


【 例 7-14】 iuc a. 


«dependency» 


2) 


?) 


视频 讲解 


它 的 功能 还 包 
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«groupId»com.alibaba«/groupId» 
«artifactId»druid«/artifactId» 
«version»1.1.6«/version» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-web«/artifactId» 

«/dependency» 

«dependency» 
«grouplId»mysql«/groupId» 
«artifactId»mysql-connector-java«/artifactId» 
«scope»runtime«c/scope» 

</dependency> 

<dependency> 
«groupId»javax.servlet«/groupId» 
«artifactId»javax.servlet-api«/artifactId» 
«version»3.1.0«/version» 


«/dependency» 


7.32 ”创建 类 DruidStatViewServlet 


在 包 com.bookcode.servlet 中 创建 类 DruidStatViewServlet， 类 代码 如 例 7-15 所 示 。 
【 例 7-15】 创建 类 DruidStatViewServlet 的 代码 示例 。 


package com.bookcode.servlet; 

import com.alibaba.druid.support.http.StatViewServlet; 

import javax.servlet.annotation.WebInitParam; 

import javax.servlet.annotation.WebServlet; 

QWebServlet (urlPatterns-"/druid/*", 

initParams-( 
QWebInitParam (name-"allow",value-"192.168.1.72,127.0.0.1"), 
QWebInitParam (name-"deny",value-"192.168.1.73"), 
//IP 黑 名 单 (存在 共同 时 ， deny 优先 于 allow) 

QWebInitParam(name-"loginUsername",value-"admin"), // 用 户 名 
@WebInitParam (name="]loginPassword",value="123456"),// 密 码 


QWebInitParam(name-"resetEnable",value-"false") 
// 禁 用 HTML 页 面 上 的 Reset A11 功能 


) 


public class DruidStatViewServlet extends StatViewServlet { 
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private static final long serialVersionUID = 1L; 


7.3.3 创建 类 DruidStatFilter 


在 包 com.bookcode.servlet 中 创建 类 DruidStatFilter， 类 代码 如 例 7-16 所 示 。 
【 例 7-16】 创建 类 DruidStatFilter 的 代码 示例 。 


package com.bookcode.servlet; 
import com.alibaba.druid.support.http.WebStatFilter; 
import javax.servlet.annotation.WebFilter; 
import javax.servlet.annotation.WebInitParam; 
QWebFilter(filterName-"druidWebStatFilter",urlPatterns-"/*»", 
initParams-( 
QWebInitParam(name-"exclusions",value-"*.js,*.gif,*.jpg,*.bmp, *.png, * 
Cc 8S5 * ICO druid/*") 
} 
) 
public class DruidStatFilter extends WebStatFilter ( 
} 


7.3.4 ”修改 入 口 类 


修改 入 口 类 ， 代 码 如 例 7-17 所 示 。 
【 例 7-17】 修改 入 口 类 的 代码 示例 。 


package com.bookcode; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.boot.web.servlet.ServletComponentScan; 
QGSpringBootApplication 
QServletComponentScan 
public class DemoApplication { 
public static void main(String[] args) ( 


SpringApplication.run(DemoApplication.class, args); 


7.3.5 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/druid/index.html， 跳 转 到 登录 页 面 
(localhost:8080/druid/login.html)， 结 果 如 图 7-8 所 示 。 输 入 正确 的 用 户 名 (admin )、 密 公 
(123456) 后 ， 正 党 登录 后 的 结果 如 图 7-9 所 示 。 
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/ « druid monitor X ue 


€ CQ | © localhost:8080/druid/login.html 


y [3 Druid Stat Index 


图 7-8 在 浏览 器 中 输入 localhost:8080/druid/index.html 的 结果 


€ Q | Q localhost:8080/druid/index html or * 


Druid Monitor zm pati Cl SQL 监 注 SOLIA Webs F8 URIS Sessionzzfz spring ks JSON API i URBE 


English | PX 


Stat Index 查看 JSON API 


7.3.6 


1.1.6 


cam alibaba druid proxy. DruidDrwer 
com.alibaba.druid.mock MockDriver 


false 


0 


180 144 


图 7-9 输入 正确 的 用 户 名 和 密码 后 ， 正 第 登录 后 的 结 末 


扩展 程序 并 运行 程序 


在 com.bookcode.config 包 中 创建 类 DruidConfiguratton， 代 人 码 如 例 7-18 所 示 。 
【 例 7-18】 创建 类 DruidConfiguration [f] f 0375 9l] . 


package com.bookcode.config; 


import 
import 
import 
import 
import 
import 
import 
import 
import 


import 


com.alibaba.druid.pool.DruidDataSource; 
com.alibaba.druid.support.http.StatViewServlet; 
com.alibaba.druid.support.http.WebStatFilter; 
org.springframework.beans.factory.annotation.Value; 
org.springframework.boot.web.servlet.FilterRegistrationBean; 
org.springframework.boot.web.servlet.ServletRegistrationBean; 
org.springframework.context.annotation.Bean; 
org.springframework.context.annotation.Configuration; 
javax.sql.DataSource; 


java.sql.SQLException; 


QConfiguration 
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public class DruidConfiguration { 
QBean 
public ServletRegistrationBean DruidStatViewServle2() ( 
ServletRegistrationBean servletRegistrationBean - new Servlet 
RegistrationBean (new $ 
StatViewServlet(), "/druid2/*"); t 
servletRegistrationBean.addInitParameter("allow", "127.0.0.1"); 
servletRegistrationBean.addInitParameter("deny", "192.168.1.73"); 
servletRegistrationBean.addInitParameter ("loginUsername", "admin"); 
servletRegistrationBean.addInitParameter ("loginPassword", "123456"); 
servletRegistrationBean.addInitParameter("resetEnable", "true"); 
return servletRegistrationBean; 
} 
QBean 
public FilterRegistrationBean druidStatFilter2()( 
FilterRegistrationBean filterRegistrationBean - new FilterRegistrationBean 


(new WebStatFilter()); 
filterRegistrationBean.addUrlPatterns ("/*"); 


filterRegistrationBean.addInitParameter ("exclusions","*.js,*.gif, 
*.Jpg,*.png,*.css,*.ico,/druid2/*"); 
return filterRegistrationBean; 
} 
QBean 
public DataSource JdruidDataSource (Value ("$S(spring.datasource.driver- 
class-namej") String driver, 
Value ("$(spring.datasource.url)") String url, 
@Value ("S$(spring.datasource.username)") String username, 
QValue ("$([spring.datasource.password)") String password) { 
DruidDataSource druidDataSource - new DruidDataSource(); 
druidDataSource.setDriverClassName (driver); 
drüurdDabasource.seruriituri): 
druidDataSource.setUsername (username); 
druidDataSource.setPassword (password); 
System.out.println("DruidConfiguration.druidDataSource(),url- 
"rurle*",username-"-rusername-",password-"-rpassword-"."); 
try ( 


druidDataSource.setFilters("stat, wall"); 


} 
catch (SQLException e) ( 


e.printStackTrace(); 


} 


telur druddDataSoHrce:; 


154 


Spring Boot 开发 实战 一 一 微 课 视 频 版 


例 7-18 在 DmidConfiguration 中 加 入 了 一 个 方法 druidDataSource() 来 进行 进行 数据 源 的 
注入 代码， 还 需要 增加 一 个 配置 文件 application.yml， 代 码 如 例 7-6 所 示 。 一 般 来 说 ， 通 过 
配置 文件 的 方式 注入 比较 好 ， 如 果 有 特殊 需求 ， 也 可 以 以 编程 方式 进行 注入 。 其 他 内 容 保 
持 不 变 并 运行 程序 ， 再 在 浏览 器 中 输入 localhost:8080/druid2/index.html， 自 动 跳 转 到 登录 
页 面 Clocalhost:8080/druid/login.html ) 。 


7.4 ”使 用 表单 验证 


表单 验证 即 校 验 用 户 提 区 的 数据 的 合理 性 ， 例 如 ， 密 人 码 长 度 是 否 大 于 
6 位 。Spring Boot 可 以 使 用 注解 @Valid 进行 表单 验证 。 常 见 的 注解 还 包括 : 

(1) (Null 限制 只 能 为 null. 

(2) @NotNull 限制 必须 不 为 null。 

(3) @AssertFalse 限制 必须 为 false. 

(4) @AssertTrue 限制 必须 为 true. 

(5) @DecimalMax(value) 限 制 必须 为 一 个 不 大 于 指定 值 value 的 数 。 

(6) @DecimalMin(value) 限 制 必须 为 一 个 不 小 于 指定 值 value 的 数 。 

(7) @Digits(integer,fraction) 限 制 必须 为 一 个 小 数 ， 且 整数 部 分 的 位 数 不 能 超过 
integer， 小 数 部 分 的 位 数 不 能 超过 fraction。 

(8) @Future 限制 必须 为 一 个 将 来 的 日 期 。 

(9) @Max(value) 限 制 必须 为 一 个 不 大 于 指定 值 value 的 数 。 

(10) @Min(value) 限 制 必须 为 一 个 不 小 于 指定 值 value 的 数 。 

(11) @Past 限制 必须 为 一 个 过 去 的 日 期 。 

(12) @Pattern(value) 限 制 必须 符合 指定 的 正则 表达 式 value. 

(13) @Size(min, max) 限 制 学 从 长 度 必须 为 min 一 max。 

(14) @NotEmpty 限制 注解 的 元 素 值 不 为 null 上 且 不 为 空 〈 字 符 串 长 度 不 为 0、 和 集合 大 
小 不 为 0)。 

(15) @NotBlank 限制 注解 的 元 素 值 不 为 空 〈 不 为 null、 去 除 首 位 空格 后 长 度 为 0)， 
不 同 于 @NotEmpty，@NotBlank 只 应 用 于 字符 串 且 在 比较 时 会 去 除 字 符 串 的 空格 。 

(16) @Email 限制 注解 的 元 素 值 是 Email， 也 可 以 通过 正则 表达 式 和 flag 指定 自 定义 
的 Email 格式 。 


7.4.1 添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ， 代 人 码 如 例 7-19 
Bras. 
【 例 7-19] i n A RR ES 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
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«artifactId»spring-boot-starter-web«/artifactId» 
«/dependency» 
«dependency» 
«groupId»mysql«/groupId» 
«artifactId»mysql-connector-java«/artifactId» E 
«/dependency» 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-data-jpa«/artifactId» 
</dependency> 


7.4.2 ”创建 类 Student 


创建 类 Student， 代 码 如 例 7-20 所 示 。 
【 例 7-20】 创建 类 Student 的 代码 示例 。 


package com.bookcode.entity; 
import javax.persistence.*; 
import javax.validation.constraints.Min; 
import javax.validation.constraints.NotEmpty; 
import javax.validation.constraints.NotNull; 
QGEntity 
QTable(name-"t student") 
public class Student { 
@Id 
QGGeneratedValue 
private Integer id; 
@NotEmpty (message=" 姓 名 不 能 为 空 ! ") 
QColumn (length-50) 
private String name; 
@NotNull (message=" 年 龄 不 能 为 空 ! ") 
@Min (value=18,message=" 年 龄 必须 大 于 18 岁 ") 
private Integer age; 
public Integer getId() ( 
return id; } 
public void setId(Integer id) { 
this.id = id; } 
public String getName() ( 
return name; ] 
public void setName(String name) ( 
this.name - name; } 
public Integer getAge() { 


return age; ] 
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public void setAge(Integer age) { 


this.age - age; ) 


7 7.4.3 创建 接口 StudentDao 


创建 接口 StudentDao， 代 码 如 例 7-21 所 示 。 
【 例 7-21】 创建 接口 StudentDao 的 代 人 示例 。 


package com.bookcode.dao; 

import com.bookcode.entity.Student; 

import org.springframework.data.jpa.repository.JpaRepository; 

public interface StudentDao extends JpaRepository«Student,Integer» { 
} 


7.4.4 ”创建 接口 StudentService 


创建 接口 StudentService, RIE am] 7-22 所 示 。 
【 例 7-22】 创建 接口 StudentService 的 代码 示例 。 


package com.bookcode.service; 
import com.bookcode.entity.Student; 
public interface StudentService { 

// 添 加 学 生 信息 到 数据 库 

public void add(Student student); 


7.4.5 创建 类 StudentServiceImpl 


创建 类 StudentServiceImpl, [V 49] 7-23 所 示 。 
【 例 7-23】 创建 类 StudentServiceImpl 的 代码 示例 。 


package com.bookcode.service.impl; 
import com.bookcode.dao.StudentDao; 
import com.bookcode.entity.Student; 
import com.bookcode.service.StudentService; 
import org.springframework.stereotype.Service; 
import javax.annotation.Resource; 
QService("studentService") 
public class StudentServiceImpl implements StudentService { 
QResource 
private StudentDao studentDao; 
QOverride 
public void add(Student student) ( 
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studentDao.save (student); 


7.4.6 ”创建 类 StudentController ' 


创建 类 StudentController， 代 人 码 如 例 7-24 所 示 。 
【 例 7-24】 创建 类 StudentController 的 代码 示例 。 


package com.bookcode.controller; 
import com.bookcode.entity.Student; 
import com.bookcode.service.StudentService; 
import org.springframework.validation.BindingResult; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 
import javax.annotation.Resource; 
import javax.validation.Valid; 
QGRestController 
QGRequestMapping ("/student") 
public class StudentController { 
QGResource 
private StudentService studentService; 
QGRequestMapping ("/add") 
public String add(G8Valid Student student, BindingResult bindingResult)(|( 
if (bindingResult.hasErrors())í( 
return bindingResult.getFieldError().getDefaultMessage(); 
) 
else( 


student Service- add (student); 


return "添加 成 功 "; 


7.4.7 ”创建 文件 studentAdd.html 


在 resources/static 目录 下 创建 文件 studentAdd.html， 代 码 如 例 7-25 所 示 。 
【 例 7-25】 创建 文件 studentAdd.html 的 代码 示例 。 


«!DOCTYPE html» 

<html> 

<head> 
<meta charset="UTF-8"/> 
<tit1le> 学 生 信息 添加 页 面 </tit1le> 
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«script src-"http://www.javal234.com/jquery-easyui-1.3.3/jquery.min. 
j]as"»efscripb» 
«script type-"text/javascript"» 
function submitData (){ 
$ $.post ("/student/add", (name: $ ("#name") .val (),age:$ ("#age") .val ()}, 
t function (result) { 
alert (result); 


); 
} 
</script>» 
</head> 
<body> 
W4: «input type "text" id-"name" name-"name"/»«br/» 
Fa «input type-"text" id-"age" name-"age"/»«br/» 
«input type-"button" onclick-"submitData()" value-"jÉ"/» 
«/body» 
«/html» 


7.4.8 创建 配置 文件 并 运行 程序 


创建 配置 文件 application.yml， 代 人 码 如 例 7-6 所 示 。 

运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/studentAdd.html， 假 如 输入 的 学 生 信 息 符 
合 在 实体 类 Student 中 设置 的 条 件 ， 结 果 如 图 7-10 所 示 。 假 如 输入 的 学 生 信息 不 符合 在 实 
体 类 Student 中 设置 的 条 件 ， 结 果 如 图 7-11 所 示 。 此 时 需要 重新 输入 学 生 人 信息。 学生 信息 
输入 成 功 后 ， 在 工具 Navicat for MySQL 中 的 结果 如 图 7-12 所 示 。 


姓名 : | 李 四 localhost:8080 显示 


SERE: 23 添加 成 功 


图 7-10 输入 的 学 生 信息 符合 在 实体 类 Student 中 设置 的 条 件 的 结果 


FEM TA 


€ C. |© localhost:8080/studentAdd.html 


姓名 : 五 | localhost:8080 显示 
年 龄 : 17 年 龄 必须 大 于 18 岁 


7-11 输入 的 学 生 信息 不 符合 在 实体 类 Student 中 设置 的 条 件 的 结果 
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四 t student @mydata (mysql) - 表 
文件 Fs å ë Ee ë U0 帮助 
ENIETESIEE 


age name 


id 
4 31 19 zs 
2 23 Æ 
3 32 于 五 


图 7-12 信息 输入 成 功 后 在 工具 Navicat for MySQL 中 的 结果 


7.5 整合 MyBatis 访问 数据 库 


MyBatis 源 目 Apache 的 开源 项 目 1Batis, 2010 年 改名 为 MyBatis. 1Batis 
是 internet 和 abatis 的 组 合 ，1Batis 包括 SQL Maps 和 Data Access Objects 视频 讲解 
(DAO). MyBatis 是 一 球 优 秀 的 持久 层 框架 ， 它 文 持 定制 化 SQL、 存 储 过 
程 以 及 高 级 映射 。MyBatis 避免 了 几乎 所 有 的 JDBC 代码 和 手动 设置 参数 以 及 获取 结果 
集 。MyBatis 可 使 用 简单 的 XML 或 注解 将 接口 和 普通 Java 对 象 (Plain Old Java Objects, 
POJO) 映射 成 数据 库 中 的 记录 。 

每 个 MyBatis 应 用 程序 都 要 使 用 SqlSessionFactory 实例 ，SqlSessionFactory 实例 可 以 
通过 SglSessionFactoryBuilder 获得 。 SglSessionFactoryBuilder 可 以 由 XML 配置 文件 或 者 预 
定义 的 配置 类 的 实例 获得 。 
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7.5.1 ”添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 Web, MyBatis, MySQL 依 
赖 ， 代 人 码 如 例 7-26 所 示 。 代 人 码 中 最 后 一 对 <dependency> 和 </dependency> 之 间 的 test 依赖 是 目 
动 添加 的 ， 不 是 手动 添加 的 结 末 。 后 面 草 节 中 添加 依赖 的 代码 中 有 有 test 依赖 也 是 如 此 ,不 再 
一 一 说 明 。 

【 例 7-26】 添加 依赖 的 代 但 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-web«/artifactId» 

«/dependency» 

«dependency» 
«groupId»org.mybatis.spring.boot«/groupId» 
«artifactId»mybatis-spring-boot-starter«/artifactId» 
«version»1.2.0«/version» 

</dependency> 

<dependency> 
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7.5.2 ”创建 类 City 


创建 类 City， 代 码 如 例 7-27 所 示 。 
【 例 7-27] 创建 类 City 的 代码 示例 。 
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7.5.3 创建 接口 CityDao 


创建 接口 CityDao， 代 码 如 例 7-28 所 示 。 
【 例 7-28】 创建 接口 CityDao 的 代码 示例 。 


package com.bookcode.dao; t 
import com.bookcode.entity.City; 
import org.apache.ibatis.annotations.*; 
import java.util.List; 
@Mapper // 标 志 为 MyBatis 的 Mapper 
public interface CityDao { 
QResults(( 


@Result (property = "id", column = "id"), 

@Result (property = "provinceId", column = "provinceId"), 
@Result (property = "cityName", column = "cityName"), 
@Result (property = "description", column = "description"), 


)) 
@Select ("SELECT * FROM city WHERE cityName = £(cityNamej]") 


List«City» findByName (String cityName); 


7.5.4 ”创建 接口 CityService 


创建 接口 CityService， 代 人 码 如 例 7-29 所 示 。 
【 例 7-29】 创建 接口 CityService 的 代码 示例 。 


package com.bookcode.service; 
import com.bookcode.entity.City; 
import java.util.List; 
public interface CityService { 
List«City» findCityByName (String cityName); 


7.5.5 ”创建 类 CityServiceImpl 


创建 类 CityServiceImpl， 代 码 如 例 7-30 所 示 。 
【 例 7-30】 创建 类 CityServiceImpl 的 代码 示例 。 


package com.bookcode.service.impl; 

import com.bookcode.dao.CityDao; 

import com.bookcode.entity.City; 

import com.bookcode.service.CityService; 
import org.springframework.stereotype.Service; 
import javax.annotation.Resource; 


import java.util.List; 
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@Service 
public class CityServiceImpl implements CityService { 
@Resource 
private CityDao cityDao; 
$ public List <City> findCityByName (String cityName) { 


t return cityDao.findByName (cityName); 


7.5.6 ”创建 类 CityController 


创建 类 CityController, fV 4| 7-31 所 示 。 
【 例 7-31】 创建 类 CityController 的 代 但 示例 。 


package com.bookcode.controller; 
import com.bookcode.entity.City; 
import com.bookcode.service.CityService; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.RequestParam; 
import org.springframework.web.bind.annotation.RestController; 
import javax.annotation.Resource; 
import java.util.List; 
QGRestController 
public class CityController { 
QResource 
private CityService cityService; 
QGRequestMapping(value = "/api/city", method = RequestMethod.GET) 
public List«City» findOneCity(GRequestParam(value-"cityName", required- 
true) String cityName) { 


return cityService.findCityByName (cityName); 


7.5.7 ”修改 配置 文件 application.properties 


配置 文件 application.properties 的 代码 如 例 7-32 所 示 。 
【 例 7-32】 配置 文件 application.properties 的 代码 示例 。 


spring.datasource.url-jdbc:mysql://localhost:3306/mytest?useUnicode-tru 
e&characterEncoding-utf8 

spring.datasource.username-root 

spring.datasource.password-sa 


spring.datasource.driver-class-name-com.mysql.jdbc.Driver 
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758 ”运行 程序 
运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/apicity?cityName=xz， 结 果 如 网 7-13 所 示 。 


Ja localhost:8080/api/city X M 


C G) localhost:8080/api/city?cityName-xz 


[l'id':1, proewinceId':2, cityName : “xz”, description : js 1] 


图 7-13 ”在 浏览 器 中 输入 localhost:8080/api/city?cityName-xz 后 的 结果 


7.6 整合 Spring Batch 和 Quartz 


Spring Batch 是 一 个 完善 的 轻 量 级 批 处 理 框架 ， 旨 在 帮助 企业 建立 健 | 
壮 、 高 效 的 批 处 理应 用 。Spring Batch 是 使 用 Java 语言 并 基于 Spring 框架 。 ”视频 讲解 
为 基础 开发 的 。Spring Batch. 提供 了 大 量 可 重用 的 组 件 ， 包 括 日 志 、 退 中 、 
事务 、 任 务 作 业 统 计 、 任 务 乍 局 、 跳 过 、 资 源 管 理 。 对 于 大 数据 量 和 融 性 能 的 批 处 理 任务 ， 
Spring Batch 同样 提供 了 高 级 功能 和 特性 来 支持 ， 如 分 区 、 远 程 功 能 。Spring Batch 不 是 
调度 框架 ， 需 要 和 调度 框架 (如 Quartz 等 ) 合作 来 构建 完成 批 处 理 任 务 。 

Quartz 是 一 个 用 Java 编写 的 开源 作业 调度 框架 ， 为 在 Java 应 用 程序 中 进行 作业 调 
度 提 供 了 简单 而 强大 的 机 制 。Quartz 可 以 与 Java EE、Java SE 应 用 程序 相 结 合 ， 也 可 以 单 
独 使 用 。Quartz 允许 程序 开发 人 员 根 据 时 间 的 间隔 来 调度 作业 。Quartz 实现 了 作业 和 触发 
器 之 轩 的 多 对 多 关系 ， 还 能 把 多 个 作业 与 不 同 的 触发 器 关联 。 为 确保 可 伸缩 性 ，Quartz X 
用 了 基于 多 线程 的 架构 。 


7.6.1 ”添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 同 添 加 依赖 ， 代 人 码 如 例 7-33 所 示 。 
【 例 7-33】 添加 依赖 的 代码 示例 。 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-test«/artifactId» 
«scope»test«/scope» 

«/dependency» 

«dependency» 
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«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-batch«/artifactId» 


«/dependency» 


«dependency» 


«groupId»com.h2database«/groupId» 
«artifactId»h2«/artifactId» 
«scope»runtime«/scope» 


</dependency> 


7.6.2 


创建 类 MyTaskOne 


创建 类 MyTaskOne， 类 代码 如 例 7-34 所 示 。 
【 例 7-34】 创建 类 MyTaskOne 的 代码 示例 。 


package com.bookcode.batchandquartz.task; 


import 
import 
import 
import 


public 


org.springframework.batch.core.StepContribution; 
org.springframework.batch.core.scope.context.ChunkContext; 
org.springframework.batch.core.step.tasklet.Tasklet; 
org.springframework.batch.repeat.RepeatStatus; 


class MyTaskOne implements Tasklet { 


public RepeatStatus execute(StepContribution contribution, ChunkContext 


chunkContext) throws Exception 


{ 


System.out.println("MyTaskOne start.."); 
System.out.println("My Code of TaskOne.."); 
System.out.println("MyTaskOne done.."); 
return RepeatStatus.FINISHED; 


7.6.3 创建 类 MyTaskTwo 


CJK MyTaskTwo， 类 代码 如 例 7-35 Pros. 
【 例 7-3S】 创建 类 MyTaskTwo [I fd fol. 


package com.bookcode.batchandquartz.task; 


import 
import 
import 
import 
public 


org.springframework.batch.core.StepContribution; 
org.springframework.batch.core.scope.context.ChunkContext; 
org.springframework.batch.core.step.tasklet.Tasklet; 
org.springframework.batch.repeat.RepeatStatus; 


class MyTaskTwo implements Tasklet { 


public RepeatStatus execute (StepContribution contribution, ChunkContext 


chunkContext) throws Exception 


{ 
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System.out.println("MyTaskTwo start.."); 
System.out.println("My code of TaskTwo .."); 
System.out.println("MyTaskTwo done.."); 

return RepeatStatus.FINISHED; 


7.6.4 创建 类 BatchConfig 


创建 类 BatchConfig， 类 代码 如 例 7-36 所 示 。 
【 例 7-36】 创建 类 BatchConfig 的 代码 示例 。 


package com.bookcode.batchandquartz.config; 
import com.bookcode.batchandquartz.task.MyTaskOne; 
import com.bookcode.batchandquartz.task.MyTaskTwo; 
import org.springframework.batch.core.Job; 
import org.springframework.batch.core.Step; 
import org.springframework.batch.core.configuration.annotation. 
Enable BatchProcessing; 
import org.springframework.batch.core.configuration.annotation. 
JobBuilderFactory; 
import org.springframework.batch.core.configuration.annotation. 
StepBuilderFactory; 
import org.springframework.batch.core.launch.support.RunIdIncrementer; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 
QGConfiguration 
QGEnableBatchProcessing 
public class BatchConfig { 
QGAutowired 
private JobBuilderFactory jobs; 
QAutowired 
private StepBuilderFactory steps; 
QBean 
public Step stepOne()( 
return steps.get ("stepoOne") 
.tasklet (new MyTaskone ()) 
bus idt); 
} 
QBean 
public Step stepTwo () { 
return steps.get ("stepTwo") 
.tasklet (new MyTaskTwo () ) 
.build(); 
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} 


GBean 
public Job demoJob()( 


return jobs.get ("demoJob") 


.incrementer (new RunIdIncrementer ()) 
.Start (stepoOne ()) 

.next (stepTwo ()) 

.build(); 


7.6.5 ”修改 入 口 类 


修改 入 口 类 ， 代 码 如 例 7-37 所 示 。 
【 例 7-37】 修改 入 口 类 的 代码 示例 。 


package com.bookcode.batchandquartz; 


import 
import 
import 
import 
import 
import 
import 


import 


org.springframework.batch.core.Job; 
org.springframework.batch.core.JobParameters; 
org.springframework.batch.core.JobParametersBuilder; 
org.springframework.batch.core.launch.JobLauncher; 
org.springframework.beans.factory.annotation.Autowired; 
org.springframework.boot.CommandLineRunner; 
org.springframework.boot.SpringApplication; 


org.springframework.boot.autoconfigure.SpringBootApplication; 


QGSpringBootApplication 


public class BatchandquartzApplication implements CommandLineRunner { 


QAutowired 


JobLauncher jobLauncher; 


QAutowired 
Job job; 
public static void main(String[] args) ( 


} 


SpringApplication.run(BatchandquartzApplication.class, args); 


QOverride 


public void run(String... args) throws Exception 


{ 


JobParameters params = new JobParametersBuilder () 


.addString ("JobID", String.valueOf (System.currentTimeMillis ())) 


.toJobParameters(); 


jobLauncher.run(job, params); 
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运行 程序 后 ， 控 制 台中 的 输出 结果 如 图 7-14 所 示 。 


MyTaskOne start.. $ 
My Code of TaskOne.. 

MyTaskOne done.. 

2018-10-09 20:30:32. 878 

MyTaskTwo start.. 

My code of TaskTwo .. 


MyTaskTwo done.. 


图 7-14 控制 台中 的 输出 结果 


7.6.7 ”增加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 增 加 Quartz 依赖 ， 代 码 如 
例 7-38 所 示 。 
【 例 7-38】 增加 Quartz 依赖 的 代码 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-quartz«/artifactId» 
«/dependency» 


7.6.8 ”修改 类 BatchConfig 


修改 类 BatchConfig， 类 代码 如 例 7-39 所 示 。 
【 例 7-39】 修改 类 BatchConfig 的 代码 示例 。 


package com.bookcode.batchandquartz.config; 

import com.bookcode.batchandquartz.task.MyTaskOne; 

import com.bookcode.batchandquartz.task.MyTaskTwo; 

import org.springframework.batch.core.Job; 

import org.springframework.batch.core.Step; 

import org.springframework.batch.core.configuration.annotation.Enable 
BatchProcessing; 

import org.springframework.batch.core.configuration.annotation. 
JobBuilderFactory; 

import org.springframework.batch.core.configuration.annotation. 
StepBuilderFactory; 
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import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 


QConfiguration 
$ @EnableBatchProcessing 
t public class BatchConfig { 
@Autowired 


private JobBuilderFactory jobs; 
QGAutowired 
private StepBuilderFactory steps; 
@Bean 
public Step stepone () { 
return steps.get ("stepOne") 
.tasklet (new MyTaskone ()) 
.build(); 
} 
@Bean 
public Step stepTwo () { 
return steps.get ("stepTwo") 
.tasklet (new MyTaskTwo () ) 
.build(); 
} 
QBean (name-"demoJobOne") 
public Job demoJobOne()|( 
return jobs.get ("demoJobOne") 
.Start (stepone ()) 
.next (stepTwo () ) 
.build(); 
} 
QBean (name-"demoJobTwo") 
public Job demoJobTwo () { 
return jobs.get ("demoJobTwo") 
.-flow(stepOne()) 
.build() 
.build(); 


7.6.9 ”创建 类 CustomQuartzJob 


创建 Quartz fEM3z 17 2825s CustomQuartzJob, Vido] 7-40 所 示 。 
【 例 7-40] 创建 类 CustomQuartzJob 的 代码 示例 。 


package com.bookcode.batchandquartz.jobs; 


import org.quartz.JobExecutionContext; 


import 
import 
import 
import 
import 
import 
import 


public 
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org.quartz.JobExecutionException; 


org.springframework.batch.core.Job; 
org.springframework.batch.core.JobParameters; 
org.springframework.batch.core.JobParametersBuilder; 
org.springframework.batch.core.configuration.JobLocator; $ 
org.springframework.batch.core.launch.JobLauncher; t 


org.springframework.scheduling.quartz.QuartzJobBean; 


class CustomQuartzJob extends QuartzJobBean { 


private String jobName; 


private JobLauncher jobLauncher; 


private JobLocator jobLocator; 


public String getJobName() ( 


} 


return jobName; 


public void setJobName (String jobName) ( 


} 


this.jobName = jobName; 


public JobLauncher getJobLauncher() ( 


} 


return jobLauncher; 


public void setJobLauncher(JobLauncher jobLauncher) ( 


} 


this.jobLauncher = jobLauncher; 


public JobLocator getJobLocator() ( 


} 


return jobLocator; 


public void setJobLocator(JobLocator jobLocator) { 


} 


this.jobLocator = jobLocator; 


QOverride 


protected void executeInternal(JobExecutionContext context) throws 


JobExecutionException 


{ 


try 
{ 

Job job = jobLocator.getJob (jobName); 

JobParameters params = new JobParametersBuilder () 
.addString("JobID", String.valueOf (System.currentTimeMillis ())) 
.toJobParameters(); 

jobLauncher.run(job, params); 


] 
catch (Exception e) 


{ 
e.printStackTrace(); 
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创建 类 QuartzConfig 


创建 类 QuartzConfig， 代 人 码 如 例 7-41 Bra. 
【 例 7-41】 创建 类 QuartzConfig 的 代 公 示例 。 


package com.bookcode.batchandquartz.config; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


java.io.IOException; 

java.util.Properties; 
com.bookcode.batchandquartz.jobs.CustomQuartzJob; 
org.quartz.JobBuilder; 

org.quartz.JobDataMap; 

org.quartz.JobDetail; 

org.quartz.SimpleScheduleBuilder; 

org.quartz.Trigger; 

org.quartz.TriggerBuilder; 
org.springframework.batch.core.configuration.JobLocator; 
org.springframework.batch.core.configuration.JobRegistry; 
org.springframework.batch.core.configuration.support. 


JobRegistry BeanPostProcessor; 


import 
import 
import 
import 
import 
import 


import 


org.springframework.batch.core.launch.JobLauncher; 
org.springframework.beans.factory.annotation.Autowired; 
org.springframework.beans.factory.config.PropertiesFactoryBean; 
org.springframework.context.annotation.Bean; 
org.springframework.context.annotation.Configuration; 
org.springframework.core.io.ClassPathResource; 


org.springframework.scheduling.quartz.SchedulerFactoryBean; 


QGConfiguration 


public 
{ 


class QuartzConfig 


QAutowired 


private JobLauncher jobLauncher; 


QAutowired 


private JobLocator jobLocator; 


QBean 


public JobRegistryBeanPostProcessor jobRegistryBeanPostProcessor 


(JobRegistry jobRegistry) ( 


JobRegistryBeanPostProcessor jobRegistryBeanPostProcessor - new 
JobRegistryBeanPostProcessor(); 
jobRegistryBeanPostProcessor.setJobRegistry (jobRegistry); 


return jobRegistryBeanPostProcessor; 
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@Bean 
public JobDetail jobOneDetail() { 
//Set Job data map 
JobDataMap jobDataMap - new JobDataMap(); 
jobDataMap.put("jobName", "demoJobOne"); $ 
jobDataMap.put("jobLauncher", jobLauncher); 
jobDataMap.put("jobLocator", jobLocator); 
return JobBuilder.newJob (CustomQuartzJob.class) 
.WithIdentity ("demoJobOne") 
.SetJobData (jobDataMap) 
.StoreDurably() 
.build(); 
} 
@Bean 
public JobDetail jobTwoDetail() { 
JobDataMap jobDataMap = new JobDataMap(); 
jobDataMap.put("jobName", "demoJobTwo"); 
jobDataMap.put("jobLauncher", jobLauncher); 
jobDataMap.put("jobLocator", jobLocator); 
return JobBuilder.newJob (CustomQuartzJob.class) 
.WithIdentity ("demoJobTwo") 
.setJobData (jobDataMap) 
.StoreDurably () 
Dus tdt; 
} 
QBean 
public Trigger jobOneTrigger() 


( 
SimpleScheduleBuilder scheduleBuilder - SimpleScheduleBuilder 


.simpleSchedule () 
.WwithIntervallInSeconds (10) 
.repeatForever(); 
return TriggerBuilder 
.newTrigger () 
.forJob (jobOneDetail ()) 
.WithIdentity ("jobOneTrigger") 
.WithSchedule (scheduleBuilder) 
.build(); 
} 
@Bean 
public Trigger jobTwoTrigger () 
{ 
SimpleScheduleBuilder scheduleBuilder = SimpleScheduleBuilder 
.SimpleSchedule () 
.WwithIntervalInSeconds (20) 
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.repeatForever (); 
return TriggerBuilder 

.newTrigger () 

.forJob (JobTwoDetail ()) 


à .WithIdentity("jobTwoTrigger") 
à .WwithSchedule (scheduleBuilder) 
 :buxddt)- 

} 
QBean 


public SchedulerFactoryBean schedulerFactoryBean() throws IOException 
{ 
SchedulerFactoryBean scheduler = new SchedulerFactoryBean(); 
scheduler.setTriggers(jobOneTrigger(), jobTwoTrigger()); 
scheduler.setQuartzProperties (quartzProperties()); 
scheduler.setJobDetails(jobOneDetail(), jobTwoDetail()); 
return scheduler; 
) 
QBean 
public Properties quartzProperties() throws IOException 
{ 
PropertiesFactoryBean propertiesFactoryBean = new Properties 
FactoryBean(); 
propertiesFactoryBean.setLocation(new ClassPathResource ("/quartz. 
properties")); 
propertiesFactoryBean.afterPropertiesSet(); 
return propertiesFactoryBean.getObject (); 


7.6.11 创建 文件 quartz.properties 和 application.properties 


在 resources 目录 下 创建 文件 quartz.properties， 代 人 码 如 例 7-42 所 示 。 
【 例 7-42】 创建 文件 quartz.properties 的 代 人 码 示 例 。 


#scheduler name will be "MyScheduler" 
org.quartz.scheduler.instanceName = MyScheduler 

#maximum of 3 jobs can be run simultaneously 
org.quartz.threadPool.threadCount - 3 

#All of Quartz data is held in memory (rather than in a database) 
org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore 


在 resources 目录 下 创建 文件 application.properties， 人 代码 如 例 7-43 所 示 。 
【 例 7-43] 创建 文件 application properties 的 代码 示例 。 


spring.batch.job.enabled-false 


spring.h2.console.enabled-true 
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修改 入 口 类 ， 代 码 如 例 7-44 所 示 。 
【 例 7-44】 修改 入 口 类 的 代码 示例 。 


package com.bookcode.batchandquartz; t 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
QSpringBootApplication 
public class BatchandquartzApplication { 

public static void main(String[] args) ( 


SpringApplication.run(BatchandquartzApplication.class, args); 


7.6.13 ”运行 程序 


运行 程序 后 ， 控 制 台 中 的 输出 结果 依次 如 图 7-15~ B] 7-18 所 示 。 


Scheduler class: 'org.quartz.core.QuartzScheduler' - running locally. 
NOT STARTED. 


Currently in standby mode. 


Number of jobs executed: 0 
Using thread pool 'org. quartz. simpl. SimpleThreadPool  - with 3 threads. 
Using job-store 'org.quartz. simpl. RAMJobStore' - which does not support persistence. and is not clustered. 


图 7-15 控制 台中 的 输出 结果 (第 一 部 分 ) 


MyTaskOne start.. MyTaskTwo start.. 
My Code of TaskOne.. 


MyTaskOne done.. 


My code of TaskTwo .. 


MyTaskTwo start.. 
MyTaskOne start.. 


My Code of TaskOne.. 
MyTaskOne done.. MyTaskTwo done.. 


My code of TaskTwo .. 


MyTaskOne start.. MyTaskTwo done.. 


图 7-16 控制 台中 的 输出 结果 (第 二 部 分 ) 图 7-17 控制 台中 的 输出 结果 (第 三 部 分 ) 


MyTaskOne start.. 

My Code of TaskOne.. 
MyTaskOne done.. 

2018-10-09 21:03:18.705 INFO 
MyTaskTwo start.. 


My code of TaskTwo .. 


MyTaskTwo done.. 


图 7-18 控制 人 台中 的 输出 结果 《第 四 部 分 ) 
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习题 7 


简 答 题 


人 向 述 对 声明 式 事 务 的 理解 。 

人 向 述 对 数据 缓存 的 理解 。 

简 述 对 Druid 的 理解 。 

人 简 述 用 于 表单 验证 的 常用 注解 的 作用 。 
简 述 对 MyBatis 的 理解 。 

何 述 对 Spring Batch 的 理解 。 

简 述 对 Quartz 的 理解 。 


验 题 


实现 声明 式 事务 。 
实现 数据 缓存 。 

实现 对 Druid 的 使 用 。 

实现 通过 整合 MyBatis 来 访问 数据 库 。 
实现 对 Spring Batch 和 Quartz 的 整合 。 


本 章 介 绍 如 何 实现 文件 上 传 、 如 何 实现 文件 下 载 、 如 何 实 现 图 片 文件 上 传 和 显示 、 如 
何 访问 HDFS、 如 何 利 用 Elasticsearch 实现 全 文 搜索 、 如 何 实 现 邮 件 发 送 、 如 何 实 现 用 REST 
Docs 创建 API 文档 等 内 容 。 


8.1 文件 上 传 


Web 应 用 项 目 中 经 常会 有 上 传 和 下 载 的 需求 ， 本 节 结 合 实例 介绍 如 何 i 
用 Spring Boot 实现 文件 的 上 传 。 视频 讲解 


8.1.1 水 加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ,代码 如 例 8-1 所 示 。 
【 例 8-1】 添加 依赖 的 代 但 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 
«/dependency» 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-thymeleaf«/artifactId» 
</dependency> 
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8.1.2 ”创建 类 FileUploadController 


创建 类 FileUploadController， 代 码 如 例 8-2 所 示 。 
【 例 8-2】 创建 类 FileUploadController 的 代码 示例 。 


t package com.bookcode.controller; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.RequestParam; 
import org.springframework.web.bind.annotation.ResponseBody; 
import org.springframework.web.multipart.MultipartFile; 
import org.springframework.web.multipart.MultipartHttpServletRequest; 
import javax.servlet.http.HttpServletRequest; 
import java.io.*; 
import java.util.List; 
QGController 
public class FileUploadController { 
QGRequestMapping ("/file") 
public String file() a 
rebnrH "Iles. } 
@RequestMapping ("/upload") 
QResponseBody 
public String handleFileUpload ((RequestParam("file")MultipartFile file) ( 
if(!file.isEmpty()) ( 
try I 
BufferedOutputStream out-new BufferedOutputStream(new FileOutputStream 
(new File(file.getOriginalFilename()))); 
out.write(file.getBytes()); 
put Flim 


out.close(); 


catch(FileNotFoundException e) ( 
e.printStackTrace(); 
return "上 传 失败 ," + e.getMessage () ; 


catch (IOException e) { 
e.printStackTrace(); 
return "上 传 失 败 ," + e.getMessage(); 


} 
return "ERHI"; 


else ( 


return "上 传 失 败 ， 因 为 文件 是 空 的 ."; 
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} 
QGRequestMapping (("/multifile") 
public String multifile() ( 
return "/multifile"; 
) $ 
@RequestMapping (value="/batch/upload", method= RequestMethod.POST) 


A 


public@ResponseBody 
String handleFileUpload(HttpServletRequest request)( 
List«MultipartFile» files = ((MultipartHttpServletRequest)request). 
getFiles ("file"); 
MultipartFile file - null; 
BufferedOutputStream stream - null; 
forlin 1 —0; ic Fi1les-s176(); 2231) 4 
file = files.get(i); 
if(!file.isEmpty()) ( 
Ery Y 
byte[] bytes - file.getBytes(); 
stream -new BufferedOutputStream(new FileOutputStream (new 
File(file.getOriginalFilename()))); 
stream.write (bytes); 
stream.close(); 
} 
catch (Exception e) { 
stream = null; 


return "You failed to upload " + i + " => "+ e.getMessage(); 


} 


else { 
return "You failed to upload " + i +" because the file was empty."; 


} 


return "upload successful"; 


8.1.3 创建 文件 file.html 


在 resources/templates 目录 下 创建 文件 file.html， 代 人 码 如 例 8-3 所 示 。 
【 例 8-3】 创建 文件 file.html 的 代码 示例 。 
«!DOCTYPE html» 


«html xmlns-"http://www.w3.0rg/1999/xhtml" xmlns:th-"http://www.thymeleaf.org" 
xmlns:sec-"http://www.thymeleaf.org/thymeleaf-extras-springsecurity3"» 
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«head» 
«meta charset-"UTF-8"/» 
«title» XÍfF«/title» 

</head> 

<body> 

<form method="POST" enctype="multipart/form-data" action="/upload"> 
«p»X1[: «input type-"file" name-"file" /»«/p» 
«p»«input type="submit" value-" Lf" /»«/p» 

«/form» 

«/body» 

«/html» 


8.1.4 创建 文件 multifile.html 


在 resources/templates 目录 下 创建 文件 multifilehtml， 人 代码 如 例 8-4 所 示 。 
【 例 8-4】 创建 文件 multifile html 的 代码 示例 。 


«!DOCTYPE html» 
«html xmlns-"http://www.w3.org/1999/xhtml" xmlns:th-"http://www.thymeleaf.org" 
xmlns:sec-"http://www.thymeleaf.org/thymeleaf-extras-springsecurity3"» 
«head» 
«meta charset-"UTF-8"/» 
<title> 多 个 文件 上 传 </title> 
</head> 
<body> 
«form method-"POST" enctype-"multipart/form-data" action="/batch/upload"> 
Owe 1: «input type-"file" name-"file" /»«/p» 
«p»X1f 2: «input type-"file" name-"file" /»«/p» 
«p»X1fH 3: «input type-"file" name-"file" /»«/p» 
«p»«input type-"submit" value-" Lf£" /»«/p» 
«/form» 
«/body» 
«/html» 


8.1.5 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080/file， 结 果 如 图 8-1 所 示 ; 选择 要 上 传 的 


文件 ， 结 果 如 图 8-2 所 示 ; 上 传 文件 成 功 之 后 的 结果 ， 结 果 如 图 8-3 MR. EA A P 
入 localhost:8080/multifile， 结 果 如 图 8-4 所 示 ; 选择 要 上 传 的 多 个 文件 ， 结 果 如 图 8-5 所 
:; 多 个 文件 上 传 成 功 后 ， 结 果 如 图 8-6 所 示 。 上 传 文件 成 功 后 ， 就 可 以 在 项 目的 根 目录 
下 看 到 所 上 传 的 文件 了 。 
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Œ | © localhost:8080/file VE: xWA — 
€ > Q |O localhost:8080/file 


文件 : | 选择 文件 | 未 选择 任何 文件 


文件 :| 选择 文件 | 2018-06-13 093353 png 
NT 
8-1 在 浏览 器 中 输入 localhost:8080/file 8-2 选择 要 上 传 的 文件 后 的 结果 
后 的 结果 


多 个 文件 上 伟 
€ C © localhost:8080/multifile 
文件 1: | 选择 文件 | 未 选择 任何 文件 
文件 2: 未 选择 任何 文件 


文件 3: 未 选择 任何 文件 


| /& localhostBOBO/upload x VOS — 
€ G ] © localhost:8080/upload 


上 传 成 功 
83 ”文件 上 传 成 功 后 的 结果 8-4 在 浏览 器 中 输入 localhost:8080/multifile 
后 的 结果 


Jue XR 
€ > C |O localhost:8080/multifile 


文件 1: | 选择 文件 |2018-05-25_200525.png 


文件 2: | 选择 文件 |2018-05-26_083932.png e localhost:8080/batch/u ~\ EN 
文件 3: | 选择 文件 [2018-05-26 084550.png € > CŒ |O localhost:8080/batch/upload 
upload successful 


图 8-5 选择 要 上 传 的 多 个 文件 后 的 结果 图 8-6 多 个 文件 上 传 成 功 后 的 结果 


8.1.6 扩展 程序 


修改 入 口 类 ， 修 改 后 的 代码 如 例 8-5 所 示 。 
[B 8-5] 修改 入 口 类 的 代码 示例 。 
package com.bookcode; 


import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
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import org.springframework.boot.web.servlet.MultipartConfigFactory; 
import org.springframework.context.annotation.Bean; 
import javax.servlet.MultipartConfigElement; 
QGSpringBootApplication 
public class DemoApplication { 
@Bean 
public MultipartConfigElement multipartConfigElement() { 
MultipartConfigFactory factory - new MultipartConfigFactory(); 
// 设 置 文件 大 小 限制 ， 超 过 设置 的 大 小 ， 则 页 面 会 抛 出 异常 信息 ， 这 时 候 就 再 要 进行 异常 信息 的 处 理 
factory.setMaxFileSize("128KB"); 
// 设 置 上 传 数据 的 总 大 小 
factory.setMaxReduestSize("256KB") ; 
return factory.createMultipartConfig(); 
} 
public static void main(String[] args) ( 
SpringApplication.run(DemoApplication.class, args); 


} 


运行 修改 后 的 入 口 尖 ， 如 果 上 传 的 文件 超过 设置 的 大 小 ， 残 会 报销 。 为 了 实现 对 上 传 


文件 大 小 的 限制 ， 也 可 以 不 修改 入 口 类 ， 而 在 配置 文件 application.properties 中 设置 上 传 文 
件 的 参数 ， 代 码 如 例 8-6 所 示 。 


【 例 8-6】 配置 文件 application.properties 的 代码 示例 。 


spring.servlet.multipart.max-file-size-128KB 


spring.servlet.multipart.max-request-size-256KB 


文件 下 载 


本 开 结 合 实 例 介 绍 如 何 用 Spring Boot 实现 文件 的 下 载 。 


8.2.1 ”添加 依赖 视频 讲解 
在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ,代码 如 例 8-1 所 示 。 
8.22 ”创建 类 FileDownloadController 


在 包 com.bookcode.controller 中 创建 类 FileDownloadController， 代 码 如 例 8-7 所 示 。 
【 例 8-7】 创建 类 FileDownloadController 的 代码 示例 。 


package com.bookcode.controller; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.RequestMapping; 


import org.springframework.web.bind.annotation.RequestMethod; 
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83 图 片 文 件 上 传 和 显示 
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8.2.3 创建 文件 downloadfile.html 


在 resources/templates 目录 下 创建 文件 downloadfile.html， 代 码 如 例 8-8 所 示 。 
【 例 8-8】 创建 文件 downloadfile.html 的 代码 示例 。 


<!DOCTYPE html» 
«html xmlns-"http://www.w3.org/1999/xhtml1" xmlns:th-"http://www.thymeleaf.org" 
xmlns:sec-"http://www.thymeleaf.org/thymeleaf-extras-springsecurity3"» 
«head» 
«meta charset-"UTF-8"/» 
«title» FAL X T«/title» 
</head> 
<body> 
«a href="/testDownload”><h2> 下 载 文件 </h2></a> 
«/body» 
«/html» 


82.4 ”运行 程序 


运行 程序 , 在 浏览 器 中 输入 localhost:8080/downloadfile, 结果 如 图 8-7 所 示 ; 单 击 “下 


载 文 件 ” 链 接 ， 就 可 以 下 载 文 件 (D:\test.txt) 了 。 


/ Ø 下 载 文 件 x \\ 


€ C | © localhost:8080/downloadfile 


下 载 文件 


图 8-7 在 浏览 器 中 输入 localhost:8080/downloadfile 后 的 结果 


本 节 结 合 实例 介绍 如 何 用 Spring Boot 实现 图 片 文件 的 上 传 和 显示 。 


8.3.1 ”添加 依赖 视频 讲解 


首先 ， 在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ， 代 码 如 


例 8-9 所 示 。 


【 例 8-9】 添加 依赖 的 代 但 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
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«artifactId»spring-boot-starter-web«/artifactId» 
«/dependency» 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-thymeleaf«/artifactId» $ 
</dependency> 
<dependency> 
«groupId»mysql«/groupId» 
«artifactId»mysql-connector-java«/artifactId» 
«/dependency» 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-data-jpa«/artifactId» 
</dependency> 


8.3.2 ”创建 类 User 


在 包 com.bookcode.entity 中 创建 类 User， 代 人 码 如 例 8-10 所 示 。 
【 例 8-10】 创建 类 User [If Vd pl. 


package com.bookcode.entity; 
import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 
import javax.persistence.Table; 
QEntity 
QTable(name - "t user") 
public class User ( 
@Id 
QGGeneratedValue 
private Long id; 
private String username; 
private String password; 
private String tupian; // 图 片 保存 的 绝对 地 址 
public User(){} 
public Long getId() { 
return id; 
} 
public void setId(Long id) { 
this.id - id; 
} 
public String getUsername() { 
return username; 


} 
public void setUsername(String username) { 


184 


Spring Boot 开发 实战 一 一 微 课 视 频 版 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 ~ 


this.username = username; 
} 
public String getPassword() ( 
return password; 
} 
public void setPassword(String password) ( 
this.password - password; 
} 
public String getTupian() ( 
return tupian; 
} 
public void setTupian(String tupian) ( 


this.tupian - tupian; 


8.3.3 创建 接口 UserRepository 


在 包 com.bookcode.dao 中 创建 接口 UserRepository， 代 人 码 如 例 8-11 所 示 。 
【 例 8-11】 创建 接口 UserRepository 的 代码 示例 。 


package com.bookcode.dao; 

import com.bookcode.entity.User; 

import org.springframework.data.jpa.repository.JpaRepository; 
public interface UserRepository extends JpaRepository«User,Long» { 
) 


8.3.4. 创建 类 MyWebConfig 


在 包 com.bookcode.config 中 创建 类 MyWebConfig， 代 公 如 例 8-12 所 示 。 
【 例 8-12】 创建 类 MyWebConfig 的 代码 示例 。 


package com.bookcode.config; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.web.servlet.config.annotation.Resource 
HandlerRegistry; 
import org.springframework.web.servlet.config.annotation. 
WebMvcConfigurerAdapter; 
QGConfiguration 
public class MyWebConfig extends WebMvcConfigurerAdapter { 
QOverride 
public void addResourceHandlers (ResourceHandlerRegistry registry) ( 
registry.addResourceHandler ("/src/main/webapp/**") . addResourceLocations 


("classpath:/webapp/"); 
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super.addResourceHandlers (registry); 


8.3.5 创建 类 UserPictureController 7 


在 包 com.bookcode.controller 中 创建 类 UserPictureController, 4R un] 8-13 所 示 。 
【 例 8-13] 创建 类 UserPictureController 的 代码 示例 。 


package com.bookcode.controller; 
import com.bookcode.dao.UserRepository; 
import com.bookcode.entity.User; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 
import org.springframework.ui.Model; 
import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.PostMapping; 
import org.springframework.web.bind.annotation.RequestParam; 
import org.springframework.web.multipart.MultipartFile; 
import java.io.*; 
QGController 
public class UserPictureController { 
QAutowired 
UserRepository userRepository; 
QGetMapping (value-"/zhuce") 
public String zhuce () { 
return "zhuce"; 
} 
QPostMapping (value-"/zhuce") 
public String tijiao(8RequestParam(value-"name") String name, 
QGRequestParam(value-"password") String password, 
QGRequestParam(value-"file")MultipartFile file, 
Model model) { 
User user = new User(); 
user.setUsername (name); 
user.setPassword (password); 
if(!file.isEmpty()) ( 
Cry I 
Bufferedoutputstream out = new BufferedOutputStream( new FileOutputStream (new 
File ("D:\\ch83\\src\\main\\webapp\\"+name+".jpg"))); 
/ /保存 图 片 到 目录 下 
out.write(file.getBytes()); 
OUt.rlusht); 
out.close(); 
String filename-"D:NNch83NNsrcNNmainNNwebapp NN" *-name-" . jpg"; 
user.setTupian(filename); 
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userRepository.save (user); // 增 加 用 户 
catch(FileNotFoundException e) { 
e.printStackTrace(); 
$ return" 上 传 失败 ,"” + e.getMessage (); 
} 
catch (IOException e) { 
e.printStackTrace(); 
return "上 传 失 败 ," + e.getMessage(); 
} 
model.addAttribute (user); 
return "permanager"; 
} 


else ( 


return "上 传 失败 ， 因 为 文件 是 空 的 ."; 


8.3.6 ”创建 文件 zhuce.html 


创建 文件 zhuce.html， 代 人 码 如 例 8-14 所 示 。 
【 例 8-14】 创建 文件 zhuce.html 的 代码 示例 。 


«'DOCTYPE html» 
<html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 


«head» 
«meta charset-"UTF-8"/» 
<title> 注 册页 面 </title> 
</head> 
<body> 
«form  action-"/zhuce"  th:action-"8(/zhucej"  method-"post" enctype= 


"multipart/form-data" » 
«label»?t 4 «/label»«input type-"text" name-"name"/» 
«label»4XfJj«/label»«input type="password" name-"password"/» 
<label> 上 传 图 片 </label> 
«input type-"file" name-"file"/» 
«input type-"submit" value-" Lf£"/» 

«/form» 

</body> 

«/htm1» 


8.3.7 ”创建 文件 permanager.html 


创建 文件 permanagerhtml， 代 码 如 例 8-15 所 示 。 
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【 例 8-15】 创建 文件 permanager.html 的 代码 示例 。 


«!DOCTYPE html» 

«html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 

«head» 
«meta charset-"UTF-8"/» 
<title> 个 人 中 心 </title> 

</head> 

<body> 

<p> 用 户 名 :</p> 

<p th:text="${user.username}"></p> 

<p> 图 片 :</p> 

«img th:src="@{${user.username}+' .Jpg'}"/> 

</body> 

«/html» 


< 


8.3.8 ”创建 配置 文件 application.yml 


创建 配置 文件 application.yml， 代 但 如 例 8-16 所 示 。 
【 例 8-16】 创建 配置 文件 application.yml 的 代 但 示例 。 


spring: 

datasource: 
driver-class-name: com.mysql.jdbc.Driver 
url: jdbc:mysql://localhost:3306/mytest 
username: root 
password: sa 

jpa: 
hibernate: 

ddl-auto: update 

show-sql: true 


8.3.9 ”创建 目录 并 运行 程序 


在 目录 src/main 下 创建 子 日 录 webapp。 
运行 程序 ， 在 浏览 堪 中 输入 localhost:8080/zhuce 并 选择 要 上 传 的 文件 ， 结 果 如 图 8-8 
所 示 。 单 击 “ 上 传 ” 按 钮 ， 成 功 上 传 图 片 文件 并 显示 文件 后 的 结果 如 图 8-9 Pra. 


mmm x ^ 


€ QC | © localhost:8080/zhuce 


姓名 Es 密码 … 上 传 图 片 | 选择 文件 |2018-06-13_122819.png 上 传 


图 8-8 在 浏览 器 中 输入 localhost:8080/zhuce 
并 选择 要 上 传 的 文件 后 的 结果 
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/ gi 个 人 中 心 x N 


€ C | © localhost:8080/zhuce 


用 户 名 : 
$ ZS 


图 片 : 


图 8-9 成 功 上 传 图 片 文件 并 显示 文件 后 的 结果 


8.4 ji HDFS 


Hadoop 分 布 式 文件 系统 (Hadoop Distributed File System, HDFS) 被 设 ai 
计 成 适合 运行 在 通用 硬件 上 的 分 布 式 文件 系统 。HDFS Z& — 6 EATER 视频 讲解 
系统 ， 适 合 部署 在 廉价 的 机 器 上 。HDFS 能 提供 高 吞吐 量 的 数据 访问 ， 非 常 
适合 大 规模 数据 集 上 的 应 用 。HDFS 是 Apache Hadoop 项 目的 一 部 分 。HDFS 提供 高 否 吐 
量 来 访问 应 用 程序 的 数据 ， 适 合 那 些 有 厦大 数据 集 的 应 用 程序 。 本 节 结 合 实例 介绍 如 何 使 
用 Spring Boot 访问 HDFS. 


8.4.1 添加 依赖 


首先 ， 在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ， 代 人 码 如 
例 8-17 所 示 。 
【 例 8-17】 添加 依赖 的 代 但 示例 。 


«dependency» 
«groupId»org.springframework.data«/groupId» 
«artifactId»spring-data-hadoop-boot«/artifactId» 
«version»2.5.0.RELEASE«/version» 

</dependency> 

<dependency> 
<groupId>org.apache .hadoop</groupId> 
«artifactId»hadoop-client«/artifactId» 
«version»2.5.2«/version» 
«scope»provided«c/scope» 

«/dependency» 
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8.4.2 ”修改 入 口 类 


修改 入 口 类 DemoApplication， 代 码 如 例 8-18 所 示 。 
【 例 8-18】 入 口 类 DemoApplication 的 代码 示例 。 


package com.bookcode; t 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.CommandLineRunner; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.apache.hadoop.fs.FileStatus; 
import org.springframework.data.hadoop.fs.FsShell; 
QGSpringBootApplication 
public class DemoApplication implements CommandLineRunner { 
QGAutowired 
FsShell fsShell; // 用 于 执行 HDFS shell 命令 的 对 象 
public void run (String... strings) throws Exception { 
// 碍 看 根 目 录 下 的 所 有 文件 
foriPpilesEa3EHS8 Filesrarus :; fsShorrt.1s4"/"3] Y 
System.out.println("» " + fileStatus.getPath()); 


} 
public static void main(String[] args) { 


SpringApplication.run(DemoApplication.class, args); 


84.3 ”运行 程序 


运行 程序 ， 在 控制 台 上 输出 di\ 下 的 所 有 子 目录 ， 如 图 8-10 所 示 。 


:/apache— jmeter-4. 0 


:/apache-maven- 3. 5. 0-bin 
:/apache-tomcat-7. 0. 81 
:/apache-tomcat-9. 0. 0. M26 
: /backup 

: /BaiduNetdiskDownload 

: /bcIDEA 

: /book 


图 8-10 ”控制 台 上 和 输出 的 d\ 下 的 所 有 子 目 录 信 息 
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8.4.4 简化 程序 


EHE pom.xml 文件 中 所 添加 的 如 例 8-17 所 示 的 依赖 。 修 改 入 口 类 DemoApplication， 
代码 如 例 8-19 所 示 。 
' 【 例 8-19】 修改 入 口 类 DemoApplication 的 代码 示例 。 


package com.bookcode; 
import org.springframework.boot.CommandLineRunner; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.util.ResourceUtils; 
import java.io.File; 
QGSpringBootApplication 
public class DemoApplication implements CommandLineRunner { 
public void run(String... strings) throws Exception | 
File file = ResourceUtils.getFile("file:d:NX"); 
if(file.exists())( 
File r Eiles Tile FasEFiTOSSRIE)- 
IEL TeS n aE AT 
for (File childFile:files)( 
System.out.println (">file:/"+childFile.getName ()); 


} 
public static void main(String[] args) 1 


SpringApplication.run(DemoApplication.class, args); 
} 


运行 程序 ， 在 控制 台 上 输出 d\ 下 的 所 有 子 目 录 ， 如 图 8-10 所 示 。 


8.5 fH Elasticsearch 实现 全 文 搜索 


Elasticsearch 是 一 个 基于 Lucene 的 搜索 服务 器 。 和 它 提 供 了 一 个 分 布 式 多 
用 户 功 能 的 全 文 搜索 引擎 和 基于 RESTful 风格 的 Web 接口 。Elasticsearch 
是 当前 流行 的 企业 级 搜索 引擎 。 建 立 一 个 网 站 或 应 用 程序 时 ， 想 要 完成 搜索 工作 的 创建 比 
较 困 难 。 开 发 者 布 望 搜索 解决 方案 要 运行 速度 快 、 零 配置、 扩展 性 好 、 服 务 可 徘 性 高 、 实 
时 性 好 、 免 费 ， 还 布 望 能 够 简单 地 使 用 JSON 通过 HTTP 来 索引 数据 。Elasticsearch 可 以 较 
好 地 帮助 开发 者 完成 这 些 目标 。 


视频 讲解 


8.5.1 ”安装 Elasticsearch J -smin 


首先 , 下 载 并 正确 安装 Elasticsearch, HHE pom.xml 文件 中 <dependencies> 和 </dependencies> 
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ZH MK, qom 8-20 所 示 。 
【 例 8-20】 nf RP. 


«dependency» 
«groupId»org.springframework.boot«/groupId» $ 
<artifactId>spring-boot-starter-data-elasticsearch</artifactId> à 
</dependency> 


8.5.2 ”创建 类 EsBlog 


在 包 com.bookcode.entity 中 创建 类 EsBlog， 代 码 如 例 8-21 所 示 。 
【 例 8-21] 创建 类 EsBlog 的 代码 示例 。 


package com.bookcode.entity; 
import java.io.Serializable; 
import org.springframework.data.annotation.Id; 
import org.springframework.data.elasticsearch.annotations.Document; 
(Document (indexName - "blog", type = "blog") //XfÀ 
public class EsBlog implements Serializable { 
erd // 主 键 
private String id; 
private String title; 
private String summary; 
private String content; 
protected EsBlog() { //JPA 的 规范 要 求 无 参 构造 图 数 ， 设 为 protected 以 防止 直接 使 用 
} 
public EsBlog(String title, String summary, String content) { 
this.title - title; 
this.summary - summary; 
this.content - content; 
} 
public String getId() ( 
return id; 
} 
public void setId(String id) { 
this.id - id; 
} 
public String getTitle() ( 
rerurn Litle; } 
public void setTitle(String title) ( 
this.title - title; 
} 
public String getSummary() { 
return summary; 
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public void setSummary (String summary) { 
this.summary = summary; 
} 
public String getContent() { 
return content; 
} 
public void setContent (String content) { 
this.content - content; 
} 
QOverride 
public String toString() ( 
return String.format( 
"EsBlog[id-'$s',title-'$s',summary-'$s',content-'$s']", 
id, title, summary, content); 


8.5.3 创建 接口 EsBlogRepository 


在 包 com.bookcode.dao 中 创建 接口 EsBlogRepository, RE 4n] 8-22 所 示 。 
【 例 8-22] 创建 接口 EsBlogRepository 的 代码 示例 。 


package com.bookcode.dao; 

import com.bookcode.entity.EsBlog; 

import org.springframework.data.domain.Page; 

import org.springframework.data.domain.Pageable; 

import org.springframework.data.elasticsearch.repository.ElasticsearchRepository; 

public interface EsBlogRepository extends ElasticsearchRepository«EsBlog,String» ( 
// 分 页 查询 博客 

Page«EsBlog» findByTitleContainingOrSummaryContainingOrContentContaining 

(String title, String summary, String content, Pageable pageable); 

} 


8.5.4 创建 类 EsBlogRepositoryTest 


创建 类 EsBlogRepositoryTest, Rin] 8-23 所 示 。 
【 例 8-23] 创建 类 EsBlogRepositoryTest 的 代码 示例 。 


package com.bookcode; 

import com.bookcode.dao.EsBlogRepository; 
import com.bookcode.entity.EsBlog; 

import org.junit.Before; 

import org.junit.Test; 

import org.junit.runner.RunWith; 


import org.springframework.beans.factory.annotation.Autowired; 
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import org.springframework.boot.test.context.SpringBootTest; 
import org.springframework.data.domain.Page; 
import org.springframework.data.domain.PageRequest; 
import org.springframework.data.domain.Pageable; 
import org.springframework.test.context.junit4.SpringRunner; à 
QGRunWith (SpringRunner.class) 
QGSpringBootTest 
public class EsBlogRepositoryTest ( 
QGAutowired 
private EsBlogRepository esBlogRepository; 
@Before 
public void initRepositoryData() { 
esBlogRepository.deleteAll(); // 清 除 所 有 数据 
/ /初始 化 数据 
esBlogRepository.save(new EsBlog ("Had I not seen the Sun", 
"I could have borne the shade", 
"But Light a newer Wilderness. My Wilderness has made.")); 
esBlogRepository.save (new EsBlog ("There is room in the halls of pleasure", 
"For a long and lordly train", 
"But one by one we must all file on, Through the narrow aisles 
OF pain: ")i; 
esBlogRepository.save (new EsBlog ("When you are old", 
"When you are old and grey and full of sleep", 
"And nodding by the fire, take down this book.")); 
} 
QTest 
public void testFindDistinctEsBlogByTitleContainingOrSummaryContaining- 
OrContentContaining() { 
Pageable pageable - PageRequest.of(0, 20); 
String title - "Sun"; 
String summary = "is"; 
String content - "down"; 
Page«EsBlog» page - esBlogRepository.findByTitleContainingOrSummary- 
ContainingOrContentContaining 
(title, summary, content, pageable); 
System.out.println("--------- SrarE I".5 
for(EsBlog blog : page) { 
System.out.println(blog.toString()); 
} 


System.out.printin ("” 一 一 一 一 一 一 一 一 一 end 1"); 
title - "the"; 

summary = "the"; 

content - "the"; 


page = esBlogRepository.findByTitleContainingOrSummary- 


ContainingOrContentContaining 
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(title, summary, content, pageable); 
System.oubE.printin("- —--———-— SpHrE x 
for(EsBlog blog : page) { 

System.out.println(blog.toString()): 


} 
DYSFOm UE pill S SS end 2"); 


8.5.5 ”修改 配置 文件 application.properties 


修改 配置 文件 application.properties， 代 码 如 例 8-24 所 示 。 
【 例 8-24】 修改 配置 文件 application.properties 的 代码 示例 。 
£Elasticsearch 服务 地 址 


spring.data.elasticsearch.cluster-nodes-localhost:9300 


# 设 置 连接 超时 时 间 


spring.data.elasticsearch.properties.transport.tcp.connect timeout = 120s 


8.5.6 ”运行 程序 (1) 


为 了 启动 Elasticsearch， 到 安装 月 录 下 运行 bin\elasticsearch.bat。 


运行 程序 中 该 测试 类 ， 控制 台 中 的 输出 结果 如 图 8-11 所 示 。 输 出 结果 显示 ， 第 一 次 以 
Sun, is 和 down 作为 查询 参数 ， 一 共有 两 条 匹配 数据 (第 一 首 诗歌 中 含有 Sun、 第 三 首 诗 
歌 中 含有 down)。 第 二 次 以 the 作为 查询 参数 ， 一 共有 三 条 匹配 数据 三 首 诗歌 中 都 合 有 


the). 


——— ———-Btart 1 
EsBlog[id-' oC4D-GMBkMI9PgbvToAn , 
EsBlog[id-' ni4D-GMBkMIOPgbvTIBD' 


EsBlog[id-' ny4D-GMBkMI 9PgbvTYCq' , 
EsBlog[id-' ni4D-GMBkM19PgbvTIBD', 
EsBlog[id-' oC4D-GMBkM19PgbvToAn' , 


end 2 


title= When you are old',summary- When you are old and grey and full of sleep',content-' And no 


,title-'Had I not seen the Sun',summary- I could have borne the shade',content-'But Light a new 


title-'There is room in the halls of pleasure’ , summary-'For a long and lordly train',content- 


title-'Had I not seen the Sun',summary- I could have borne the shade',content-' But Light a new 


title=’ When you are old',summary-' When you are old and grey and full of sleep',content-' And no 


图 8-11 控制 台中 的 输出 结果 


8.5.7 ”创建 类 BlogController 


在 包 com.bookcode.controller 中 创建 类 BlogController， 代 人 码 如 例 8-25 所 示 。 
【 例 8-25】 创建 类 BlogController 的 代码 示例 。 


package com.bookcode.controller; 


import java.util.List; 
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import com.bookcode.dao.EsBlogRepository; 
import com.bookcode.entity.EsBlog; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.data.domain.Page; 
import org.springframework.data.domain.PageRequest; E 
import org.springframework.data.domain.Pageable; t 
import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestParam; 
import org.springframework.web.bind.annotation.RestController; 
QGRestController 
QGRequestMapping ("/blogs") 
public class BlogController { 
QAutowired 
private EsBlogRepository esBlogRepository; 
QGetMapping 
public List«EsBlog» list(GRequestParam(value-"title",required-false, 
defaultValue-"") String title, 
QGRequestParam(value-"summary",required-false,defaultValue-"") 
String summary,RequestParam(value-"content",required-false, 
defaultValue-"") String content, @RequestParam (value= 
"pageIndex",required-false,defaultValue-"0") int pageIndex, 
QGRequestParam(value-"pageSize",required-false, 
defaultValue-"10") int pageSize) ( 
// 数 据 在 Test 里 面 先 初始 化 了 ， 这 里 只 管 取 数 据 
Pageable pageable = PageRequest.of(pageIndex, pageSize); 
Page«EsBlog» page = esBlogRepository.findByTitleContainingOrSummary- 
ContainingOrContentContaining 
(title, summary, content, pageable); 


return page.getContent(); 


8.5.8 ”运行 程序 (2) 


运行 程序 , 为 了 查询 id 中 包含 1、summary 中 包含 love 和 content 中 包含 you 的 博客 信 
息 ， 在 浏览 器 中 输入 localhost:8080/blogs?id=1&summary=love&content=you， 输 出 结果 如 
图 8-12 所 示 。 


gj localhost:8080/blogs?ic x / 


c E | © localhost:-8080/bloqs?id zi& summary-love&content- you 


[{" id" "nydD-GMBENI P gb TC, "title":"There is roon in the halls of pleasure", ^ummary :下 ang and lordly tr ain’, cante n-":"But oe by one we nust all file on, Through the n 
["id': "oc dD-INENTU SPb To fm^, title”: When you are old”. “Tar 了 : ”When wo are old and erey nus full of sleep”, "content  :"Pnd noddine tw tbe fires take dom this took, ^]. fid”: "iD. 
GNBKIISPzbvTIBED^, "title": "Had I not seen the Sw. "summary |^ T could hawe borne the shade”, "content": "But Light a newer Vildemess, My Wilderness has node, 1] 


图 8-12 ”在 浏览 器 中 输入 localhost:8080/blogs?id-i&summary-love&content-you 
后 的 结果 
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8.6 ”实现 邮件 发 运 


现在 大 部 分 网 站 在 用 户 注册 时 都 要 求 用 户 填写 邮箱 进行 注册 验证 ， 因 ” up 
此 发 送 邮 件 是 网 站 必 备 的 功能 之 一 。 在 没有 框架 之 前 ， 一 般 是 通过 Java 日 视频 讲解 
市 的 JavaMail 类 来 发 送 邮 件 ， 后 来 Spring 推出 了 JavaMailSender ZS CX fij 
化 了 发 送 邮 件 的 过 程 ， 现 在 的 Spring Boot 又 将 其 封装 成 了 spring-boot-starter-mail 模块 。 


— A 


8.6.1. 登录 邮箱 并 开局 授权 码 


以 163 邮箱 为 例 ， 按 照 图 8-13 一 图 8-15 依次 开局 邮箱 授权 但 。 


A 常规 设置 


邮箱 密 始 修改 
帐号 与 邮箱 中 心 
邮箱 安全 设置 
POP3/SMTP/IMAP 


EISE 


图 8-13 ”选择 “设置 >， 进行 POP3 等 设置 图 8-14 "Ri; JP mE IU 


ipi 
授权 码 是 用 于 登录 第 二 方 邮 件 客 户 端 的 专用 密码 。 
适用 于 登录 以 下 服务 : POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV 服 务 . 


o 


ERES D ES: 


您 已 局 用 授权 码 ， 请 使 用 授权 人 磺 登 录 第 二 方 邮件 客户 端 


图 8-15 选择 “开局 ”授权 人 码 


8.6.2 ”添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ， 代 但 如 例 8-26 所 示 。 
【 例 8-26】 添加 依赖 的 代码 示例 。 
«dependency» 


«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-mail«/artifactId» 
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«/dependency» 

«dependency» 
«groupId»org.springframework«/groupId» 
«artifactId»spring-web«/artifactId» 


«version»5.0.9.RELEASE«/version» à 
</dependency> t 
<dependency> 


«groupId»junit«/groupId» 
«artifactId»junit«/artifactId» 
«version»4.12«/version» 
«scope»test«/scope» 

</dependency> 

<dependency> 
<groupId>org.springframework</groupId> 
«artifactId»spring-test«/artifactId» 
«version»55.0.6.RELEASE«/version» 
«scope»test«/scope» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-test«/artifactId» 
«version»2.0.2.RELEASE«/version» 
«scope»test«/scope» 

«/dependency» 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-thymeleaf«/artifactId» 

</dependency> 


8.6.3 创建 接口 EmailService 


创建 接口 EmailService， 代 码 如 例 8-27 所 示 。 
【 例 8-27】 创建 接口 EmailService 的 代码 示例 。 


package com.bookcode.service; 

public interface EmailService { 
// 发 送 简单 邮件 
public void sendSimpleEmail(String to, String subject, String content); 
/ [RIÉ HTML 格式 邮件 
public void sendHtmlEmail(String to, String subject, String content); 
// 发 送 帝 附件 的 邮件 
public void sendAttachmentsEmail(String to, String subject, String 
content, String filePath); 
// 发 送 帝 静态 资源 的 邮件 


public void sendInlineResourceEmail(String to, String subject, String 
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content, String rscPath, String rscId); 


8.6.4 


创建 类 EmailServiceImp 


创建 类 EmailServiceImp， 代 人 码 如 例 8-28 所 示 。 
【 例 8-28] 创建 类 EmailServiceImp 的 代码 示例 。 


package com.bookcode.service.impl; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


import 


org.slf4j.Logger; 

org.slf4j.LoggerFactory; 
org.springframework.beans.factory.annotation.Autowired; 
org.springframework.beans.factory.annotation.Value; 
org.springframework.core.io.FileSystemResource; 
org.springframework.mail.SimpleMailMessage; 
org.springframework.mail.javamail.JavaMailSender; 
org.springframework.mail.javamail.MimeMessageHelper; 
org.springframework.stereotype.Component; 
javax.mail.MessagingException; 
javax.mail.internet.MimeMessage; 


java.io.File; 


QGComponent 


public 


class EmailServicelmp implements EmailService ( 


private final Logger logger = LoggerFactory.getLogger (this.getClass()); 


QAutowired 
private JavaMailSender mailSender; //Spring 提供 的 邮件 发 送 类 


Value ("$(spring.mail.username]") 


private String from; 


QOverride 


public void sendSimpleEmail(String to, String subject, String content) { 


} 


SimpleMailMessage message = new SimpleMailMessage(); // 创 建 简单 邮件 消息 


message.setFrom(from); // 设 置 发 送 人 
message.setTo (to); // 设 置 收 件 人 
message.setSubject (subject); // 设 置 主 题 
message.setText (content); // 设 置 内 容 
try 

mailSender.send (message); // 执 行 发 送 邮件 


1ogger .info(" 简 单 邮 件 已 经 发 送 。") ; 
} 
catch (Exception e) ( 


logger.error ("发 送 简 单 邮件 时 发 生 异 常 ! ", e); 


QOverride 


public void sendHtmlEmail (String to, String subject, String content) { 
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MimeMessage message = mailSender.createMimeMessage(); // 创 建 一 个 MINE 消息 
Erw 
//true 表示 需要 创建 一 个 multipart message 
MimeMessageHelper helper = new MimeMessageHelper (message, true); 
helper.setFrom(from); 
helper.setTo (to); 
helper.setSubject (subject); 
helper.setText(content, true); 
mailSender.send (message); 
logger.info ("HTML 邮件 发 送 成 功 ") ; 
} 


catch (MessagingException e) { 


logger.error ("发 送 HTML 邮件 时 发 生 异 常 ! ", e); 


} 
QOverride 
public void sendAttachmentsEmail(String to, String subject, String 
content, String filePath) { 
MimeMessage message = mailSender.createMimeMessage(); // 创 建 一 个 MINE 消息 
Ery í 
MimeMessageHelper helper = new MimeMessageHelper (message, true); 
helper .setFrom (from); 
helper.setTo (to); 
helper.setSubject (subject); 
helper.setText(content, true);  //true 表示 这 个 邮件 是 有 附件 的 
FileSystemResource file = new FileSystemResource (new File(filePath)); 
/ /创建 文件 系统 资源 
String fileName = filePath.substring(filePath.lastIndexOf (File. 
separator)); 
helper.addAttachment(fileName, file); // 添 加 附件 
mailSender.send (message); 
logger.info(" 带 附件 的 邮件 已 经 发 送 。"); 
} 
catch (MessagingException e) { 


logger .error ("发 送 帝 附件 的 邮件 时 发 生 异 常 ! ", e); 


} 
QOverride 
public void sendInlineResourceEmail(String to, String subject, String 
content, String rscPath, String rscId) | 
MimeMessage message = mailSender.createMimeMessage(); 
try f 
MimeMessageHelper helper - new MimeMessageHelper (message, true); 
helper.setFrom(from); 


helper.setro(to); 
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helper.setSubject (subject); 
helper.setText(content, true); 
FileSystemResource res = new FileSystemResource (new File (rscPath)); 
// 添 加 内 联 资 源 ， 一 个 id 对 应 一 个 资源 ， 最 终 通过 ia 来 找到 该 资源 
$ helper.addInline(rscId, res); 
t // 添 加 多 个 图 片 可 以 使 用 多 条 <img src-'cid:" + rscId + "' > 和 helper. 
//addInline(rsclId, res) 来 实现 
mailSender.send (message); 
logger.info ("WB AWHI CZAR. "); 
) 


catch (MessagingException e) { 


logger.error ("AXE RARS vEUR IBI ER E! ", e); 


8.6.5 创建 类 DemoApplicationTests 


创建 类 DemoApplicationTests, [V in] 8-29 所 示 。 
【 例 8-29】 创建 类 DemoApplicationTests 的 代码 示例 。 


package com.bookcode; 
import org.junit.Test; 
import org.junit.runner.RunWith; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.test.context.SpringBootTest; 
import org.springframework.test.context.junit4.SpringRunner; 
import org.thymeleaf.TemplateEngine; 
import org.thymeleaf.context.Context; 
QGRunWith (SpringRunner.class) 
QGSpringBootTest 
public class DemoApplicationTests ( 
QTest 
public void contextLoads() { 
) 
QGAutowired 
private EmailService emailService; 
QTest 
public void sendSimpleMail() throws Exception { 
emailService.sendSimpleEmail("972918qq.com","this is simple 
mail” " hello Ik="); 
} 
@Test 
public void sendHtmlMail() throws Exception { 
String content="<html>\n" + 
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"cbody»sXu F 
" — «h3»hello world ! 这 是 一 封 HTML 邮件 !</h3>\n" + 
"«/body»Mn" « 
"chm o": 
emailService.sendHtmlEmail ("9729180qq.com","this is html mail",content); 
} 
QTest 
public void sendAttachmentsMail() ( 
String filePath-"d:NMpk.png"; 
emailService.sendAttachmentsEmail("9729160qq.com", "主题 ， 带 附件 的 邮件 "， 
" 收 到 附件 ， 请 奋 收 ! ", filePath); 
} 


QTest 
public void sendInlineResourceMail() ( 
String rsclId - "001"; 


String content="<html><body> 这 是 有 图 片 的 邮件 : «img src-N'cid:" + rscId 
* "N' »«/body»«/htm1»"; 
String imgPath = "d:\\pk.png"; 
emailService.sendInlineResourceEmail("972918qq.com", "主题 ， 这 是 有 图 
片 的 邮件 "， content, imgPath, rscId); 

} 

QAutowired 

private TemplateEngine templateEngine; 

QTest 

public void sendTemplateMail() ( 
// 创 建 邮 件 正文 
Context context = new Context (); 
context.setVariable("username", "jkK-—"); 
String emailContent - templateEngine.process("email", context); 
System.out.println (emailContent); 
emailService.sendHtmlEmail ("97291@qq. com", "主题 : 这 是 模板 邮件 ", emailContent); 


8.6.6 ”修改 配置 文件 application.properties 


修改 配置 文件 application.properties， 代 人 码 如 例 8-30 所 示 。 
【 例 8-30】 修改 配置 文件 application.properties 的 代 公 示例 。 


# 邮 箱 服 务 器 地 址 
spring.mail.host-smtp.163.com 
# 用 户 名 

# 请 修改 成 您 自己 的 邮箱 和 授权 码 
spring.mail.username-ws8163.com 


# 授 权 密 码 
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spring.mail.password-w1234567 
spring.mail.default-encoding-UTF-8 


8.6.7 ”创建 文件 email.html 


创建 文件 emailhtml， 代 码 如 例 8-31 所 示 。 
【 例 8-31】 创建 文件 email.html 的 代码 示例 。 


«'DOCTYPE html» 
«html lang-"zn" xmlins:th-"http://www.thymeleaf.org"» 
«head» 
«meta charset-"UTF-8"/» 
«title»Title«/title» 
</head> 
<body> 
<h4 th:text=" | 尊敬 的 S{username} :1"></h4><br /><br /> 
感谢 您 对 spring Boot 的 关注 与 支持 。<br /> 
«/body» 
</html> 


8.6.8 ”运行 程序 


运行 程序 中 测试 类 ， 则 在 收 件 人 的 邮箱 中 依次 收 到 HIML、 模 板 、 简 单 、 帝 附件 、 有 
图 片 的 邮件 5 封 ， 如 图 8-16 所 示 。5 封 邮 件 的 内 容 依次 如 图 8-17 一 图 8-21 所 示 。 


主题 : 这 是 有 图 片 的 邮件 - 这 是 有 图 片 的 邮件 : 
主题 ; 带 附件 的 邮件 - 收 到 附件 ， 请 齐 收 ! 


this is simple mail - hello X= 


mmg 
Wi 


this is html mail - hello world ! 这 旦 一 封 HTML 邮件 ! 


图 8-16 ” 收 到 5 封 邮 件 的 信息 


hello world ! 这 旺 一 封 HTML 邮 件 ! 


图 8-17 this is html mail 的 邮件 内 容 


感谢 您 对 Spring Boot 的 关注 与 支持 。 hello 张 三 


图 8-18 ”主题 为 “这 是 模板 邮件 ”的 邮件 内 容 图 8-19 this is simple mail 的 邮件 内 容 
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e 附件 (1 个 ) 


ENAME 


| pk.png (254.17K) 
E Ma Fa Ba ite 


图 8-20 ”主题 为 “这 附件 的 邮件 ”的 邮件 内 容 


这 是 有 图 片 的 邮件 : 


图 8-21 主题 为 “这 是 有 图 片 的 邮件 ”的 邮件 内 容 


8.7 FH REST Docs 创建 API 文档 


本 节 介绍 如 何 用 Spring 官方 推荐 的 REST Docs 创建 API 文档 。 创 建 一 视频 讲解 
个 简单 项 目 ， 先 将 HTTP 接口 通过 API 文档 暴露 出 来 。 再 通过 JUnit 单元 测 | 
试 和 Spring 的 MockMVC 生成 文档 。 并 通过 单元 测试 生成 API 文档 的 ADOC 文件 
CAsciidoctor 格式 ) 后 ， 骨 将 ADOC 文件 转换 成 HTML 文件 ， 这 个 HTML 文件 可 以 通过 网 


8.7.1 ”添加 依赖 


在 pom.xml X ffF'P «dependencies» 4l —/dependencies» Ż [E] 5 Jn f f, ARAS tup] 8-32 
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所 示 。 
【 例 8-32】 添加 依赖 的 代 但 示例 。 
«dependency» 
$ «groupId»org.springframework.boot«/groupId» 
t <artifactId>spring-boot-starter-web</artifactīId> 
</dependency> 
<dependency> 
«groupId»org.springframework.restdocs«/groupId» 
«artifactId»spring-restdocs-mockmvc«/artifactId» 
«scope»test«/scope» 
</dependency> 


8.7.2 ”创建 类 HomeController 


创建 类 HomeController， 代 码 如 例 8-33 所 示 。 
【 例 8-33】 创建 类 HomeController 的 代码 示例 。 


package com.bookcode.controller; 
import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.RestController; 
import java.util.Collections; 
import java.util.Map; 
QGRestController 
public class HomeController { 
QGGetMapping ("/") 
public Map«String, Object» greeting() { 


return Collections.singletonMap("message", "Hello World"); 


87.3 ”运行 程序 


运行 程序 后 ， 在 浏览 器 中 输入 localhost:8080， 结 果 如 图 8-22 所 示 。 


E | Oflllocalhost:8080 


全 message :Hello World”} 


图 8-22 ”在 浏览 器 中 输入 localhost:8080 后 的 结果 
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8.74 创建 类 WebLayerTest 


创建 类 WebLayerTest， 代 人 码 如 例 8-34 所 示 。 
【 例 8-34] 创建 类 WebLayerTest 的 代码 示例 。 


package com.bookcode; ' 
import com.bookcode.controller.HomeController; 
import org.junit.Test; 
import org.junit.runner.RunWith; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.test.autoconfigure.restdocs. 
AutoConfigureRestDocs; 
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest; 
import org.springframework.test.context.junit4.SpringRunner; 
import org.springframework.test.web.servlet.MockMvc; 
import static org.hamcrest.Matchers.containsString; 
import static org.springframework.restdocs.mockmvc. 
MockMvcRestDocumentation.document; 
import static org.springframework.test.web.servlet.request. 
MockMvcRequestBuilders.get; 
import static org.springframework.test.web.servlet.result.MockMvcResult- 
Handlers.print; 
import static org.springframework.test.web.servlet.result.MockMvcResult- 
Matchers.content; 
import static org.springframework.test.web.servlet.result.MockMvcResult- 
Matchers.status; 
QGRunWith (SpringRunner.class) 
QWebMvcTest (HomeController.class) 
QGAutoConfigureRestDocs(outputDir = "target/snippets") 
public class WebLayerTest ( 

QAutowired 

private MockMvc mockMvc; 

QTest 

public void shouldReturnDefaultMessage() throws Exception { 

this.mockMvc.perform(get ("/")) .andDo (print () ) .andExpect (status () .isOk()) 
.andExpect (content ().string(containsString ("Hello World"))) 


.andDo (document ("home") ); 


局 动 单 元 测试 ， 测 试 通过 ， 发 现在 target 文件 夹 下 生成 了 一 个 snippets X fF3&é, HX 
下 还 生成 了 一 些 ADOC 文件 (Asciidoctor 格式 )， 如 图 8-23 所 示 。 
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v target 
Ml classes 
Ml generated-docs 


a. index.html 


Ml generated-sources 

Ml generated-test-sources 

B3 maven-archiver 

Ml maven-status 

Ml snippets 

v Mhome 
& curl-request.adoc 
& http-request.adoc 
四 http-response.adoc 
& httpie-request.adoc 
d request-body.adoc 
& response-body.adoc 


图 8-23 ”自动 生成 的 ADOC 文件 


8.7.5 创建 文件 index.adoc 


在 src/main/asciidoc 目录 下 创建 文件 mdex.adoc， 代 码 如 例 8-35 所 示 。 
【 例 8-35] 创建 文件 mdex.adoc 的 代码 示例 。 


= 用 Spring REST Docs 构建 文档 

This is an example output for a service running at http://localhost:8080: 
.request 

include::(snippets)/home/http-request.adoc[] 

.response 


include::(snippets)/home/http-response.adoc[] 


这 个 例子 非常 简单 ， 通 过 单元 测试 和 一 些 简单 的 配置 就 能 够 得 到 api 文档 了 。 


8.7.6 ”添加 插件 


在 pom.xml 文件 中 <plugins> 和 </plugins> 之 间 添 加 插件 asciidoctor-maven-plugin, fV 
如 例 8-36 所 示 。 
【 例 8-36】 添加 插件 asciidoctor-maven-plugin 的 代码 示例 。 


«plugin» 
«groupId»org.asciidoctor«/groupId» 
«artifactId»asciidoctor-maven-plugin«/artifactId» 
«executions» 


«execution» 


第 8 章 Spring Boot 的 文件 应 用 一 起 9/ 


«id»generate-docs«/id» 

«phase»prepare-packagec/phase» 

«goals» 
«goal»process-asciidoc«/goal» 


«/goals» 


< 


<configuration> 
<sourceDocumentName>index .adoc</sourceDocumentName> 
«backend»html«/backend» 
«attributes» 
«snippets»$(project.build.directory)/snippets 
«/snippets» 
«/attributes» 
«/configuration» 
«/execution» 
«/executions» 


«/plugin» 


8.7.7 ”利用 Maven 的 package 命令 生成 文件 


可 以 利用 Maven 的 package 命令 (如 图 8-24 所 示 ) 根 据 index.adoc 文件 生成 文件 index.html。 


^g DemoApplication v 


Maven Projects 


G m$ iE c-r bg 


v gf demo 


v BLtfecycle 
$ clean 
£* validate 
$ compile 
2 test 

package 

EE verify 
£* install 
$ site 
© deploy 


图 8-24 Maven 的 package 命令 


目 动 生成 的 文件 index.html 在 /target/generated-docs 目录 下 。 用 浏览 器 打开 文件 
index.html, 结果 如 图 8-25 所 示 。 在 浏览 器 中 单 击 index.html 中 的 链接 http://localhost:8080， 
跳 转 到 如 图 8-22 所 示 的 界面 。 
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y M RB Spring REST Docs it. x WX 


6 | © [ile:///D:/ch87/target/generated-docs/index.html 


用 Spring REST Docs 构建 文档 


This is an example output for a service running at http://localhost:8080: 
request 


GET / HTTP/1.1 
Host: localhost:8080 


response 
HTTP/1.1 200 OK 
Content-Type: application/json;charset-UTF-8 
Content-Length: 25 


("message":"Hello World") 


这 个 例子 非常 简单 ， 通 过 单元 测试 和 一 些 简单 的 配置 就 能 够 得 到 api 文 档 了 。 


Last updated 2018-10-18 20:51:23 CST 


图 8-25 用 浏览 器 中 打开 文件 index.html 的 结果 


习题 8 


简 答 题 

l. HRX HDFS 的 理解 。 

2， 人 简 述 对 Elasticsearch 的 理解 。 
实验 题 

实现 文件 上 传 。 

实现 文件 下 载 。 
实现 图 片 文件 上 传 和 显示 。 

实现 输出 d 盘 下 文件 名 。 

利用 Elasticsearch 实现 全 文 搜索 。 
实现 不 同类 型 邮件 的 发 送 。 
实现 用 REST Docs 创建 API 文档 。 
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本 章 先 对 Spring Boot 的 WebFlux (下 文 有 时 简称 为 WebFlux) 及 其 编程 模型 进行 简单 
介绍 ， 在 此 基础 上 介绍 Spring Boot 的 WebFlux 入 门 应 用 以 及 在 WebFlux 开发 中 如 何 实现 
RESTful 服务 、 如 何 访问 MongoDB 数据 库 、 如 何 使 用 Thymeleaf 和 MongoDB、 如 何 访问 
Redis 数据 库 、 如 何 使 用 WebSocket。 


9.1 WebFlux 及 其 编程 模型 


9.1.1 WebFlux 


Spring Boot 的 WebFlux 常用 生产 特性 包括 啊 应 式 API ARRAS Starter 组 件 、 编 
程 模型 、 适 用 性 ， 还 有 对 日 志 、Web、 消 息 、 测 试 及 扩展 等 文 持 。 

要 了 解 WebFlux, 首先 要 了 解 什 么 是 啊 应 式 流 (了 Reactive Streams ) 。 啊 应 式 流 是 JVM 中 
和 面 癌 流 的 库 标 准 和 规范 ， 一 般 由 发 布 者 (发 布 元 素 到 订阅 者 )、 订 阅 者 (消费 元 素 )、 订 阅 
《发 布 者 创建 后 与 订阅 者 共享 )、 处 理 器 〈 在 发 布 者 与 订阅 者 之 间 处 理 数 据 ) 组成。 啊 应 流 
的 特点 包括 : 处 理 可 能 无 限 数量 的 元 素 ; 按 顺 序 处 理 ; 组 件 之 间 异 步 传递 ;强制 性 非 阻 塞 


用 于 确保 发 布 者 发 布 元 素 太 快 时 不 会 去 压制 订阅 者 。 利 用 啊 应 式 流 规范 进行 啊 应 式 编 程 是 
基于 异步 和 事件 驱动 的 非 阻 塞 程 序 , 啊 应 式 编 程 通过 基于 啊 应 式 流 规范 实现 的 框架 Reactor 
去 实现 。 

Spring Boot 的 WebFlux 就 是 基于 Reactor 实现 的 ,-Reactor 杠 架 是 Spring Boot 中 WebFlux 
啊 应 库 依 赖 ， 通 啊 应 式 流 并 与 其 他 啊 应 库 交 互 。 它 提供 了 两 种 响应 式 API。 啊 应 式 API 一 
般 是 将 Publisher 作为 输入 ,在 框架 内 部 转换 成 Reactor 类 型 并 处 理 多 辑 ， 然 后 返回 Flux 或 
Mono 作为 输出 。 
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Spring Boot 2.0 包括 一 个 新 的 spring-webflux 模块 。 该 模块 包含 对 啊 应 式 HTTP 和 
WebSocket 客户 端的 支持 以 及 对 REST、HTML 和 WebSocket 交互 等 程序 的 支持 。Spring 5 
的 Web 模块 中 包含 了 WebFlux 的 HTTP 抽象 。 类 似 于 Servlet API，WebFlux 提供 了 
WebHandler 的 API 去 定义 非 阻 塞 API 抽象 接口 。 

WebFlux 默认 是 通过 Netty A, HHR Umo ASEAN 8080。 夯 外 还 提供 了 对 
Tomcat, Jetty, Undertow 等 容器 的 文 持 。 开 发 者 添加 依赖 后 ， 即 可 配置 并 使 用 对 应 的 内 骨 
Ad Ss DI] o 

Spring Boot 的 Webflux 也 提供 了 很 多 “ 开 箱 即 用 ”的 Starter 组 件 。 只 需要 在 Maven 
配置 文件 pom.xml 中 添加 对 应 的 依赖 配置 ， 即 可 使 用 对 应 的 Starter 组 件 。 例 如 ， 添 加 
spring-boot-starter-webflux 依赖 ， 就 可 用 于 构建 啊 应 式 API 服务 ， 其 包含 了 WebFlux 和 内 


ches 


9.1[2 Spring Boot 的 WebFlux 编程 模型 


Spring Boot 的 WebFlux 开发 有 了 两 种 编程 模型 : 一 种 是 注解 方式 ， 示例 代码 如 例 9-1 所 
示 ; 男 一 种 是 使 用 功能 性 新 点 方式 ， 示 例 代 人 码 如 例 9-2 所 示 。 
【 例 9-1】 用 注解 方式 进行 Spring Boot 的 WebFlux 开发 的 代码 示例 。 


QRestController 
QGRequestMapping ("/users") 
public class MyRestController ( 
QGetMapping ("/ {user}") 
public Mono<User> getUser (@PathVariable Long user) ( 
Fem 
} 
@GetMapping ("/{user}/customers") 
public Flux«Customer» getUserCustomers (@PathVariable Long user) { 
PE 
} 
QDeleteMapping ("/ {user}") 
public Mono«User» deleteUser (@PathVariable Long user) { 
E ves 


} 


例 9-2 是 例 9-1 的 功能 变 体 , 它 将 路 由 配置 与 请 求 的 实际 处 理 分 开 ,， 基 于 lambda 轻 量 
级 编程 模型 来 实现 路 由 和 处 理 请 求 。 

【 例 9-2】 使 用 功能 性 羡 点 方式 进行 Spring Boot 的 WebFlux 开发 的 代码 示 例 。 

// 路 由 配置 类 

@Configuration 


public class RoutingConfiguration { 


@Bean 
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public RouterFunction«ServerResponse» monoRouterFunction (UserHandler 
userHandler) { 
return route (GET ("/(user)").and(accept (APPLICATION JSON)), 
userHandler::getUser) 
.andRoute (GET ("/(user)/customers").and(accept (APPLICATION JSON)), à 
userHandler::getUserCustomers) 
.-andRoute (DELETE ("/(userj").and(accept (APPLICATION JSON)), 
userHandler::deleteUser); 
} 


} 
// 请 求 的 实际 处 理 类 
@Component 
public class UserHandler { 
public Mono<ServerResponse> getUser(ServerRequest request) { 
T 


} 
public Mono«ServerResponse» getUserCustomers(ServerRequest request) { 


"(pee 


} 
public Mono«ServerResponse» deleteUser(ServerRequest request) { 


BETR 


} 

Spring Boot 的 WebFlux 和 Spring MVC 既 有 交集 也 有 差异 ,如 Spring Boot 的 WebFlux 
能 更 好 地 文 撑 并 发 。 一 般 来 说 ，Spring MVC 用 于 同步 处 理 ，Spring Boot 的 WebFlux 用 于 
异步 处 理 。 如 条 用 Spring MVC WAEI ERNA mieh, MAA DREH Spring Boot 的 
WebFlux。 在 使 用 微服 务 体系 结构 时 ，Sprmg Boot 的 WebFlux 和 Spring MVC 可 以 混合 使 
用 。 尤 其 是 开发 输入 输出 密集 型 服务 时 ， 可 以 选择 Spring Boot 的 WebFlux 去 实现 。 


9.2 WebFlux 入 门 应 用 
9.2.1 ”添加 依赖 


视频 讲解 
在 pom.xml X fF? «dependencies^ 4l-/ dependencies» Z. [H] 4s DNAT Ha I] Reactive Web 依 
赖 ， 代 码 如 例 9-3 所 示 。 
【 例 9-3】 添加 Reactive Web 依赖 的 代码 示例 。 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-webflux«/artifactId» 
</dependency> 
<dependency> 
<groupId>io.projectreactor</groupId> 
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rerioackeld reae Or LESES Iari irae Tos 
<scope>test</scope> 


</dependency> 


9.2.2 


创建 类 CityHandler 


创建 类 CityHandler， 代 人 码 如 例 9-4 所 示 。 
【 例 9-4】 创建 类 CityHandler 的 代码 示例 。 


package com.bookcode.handler; 


import 
import 
import 
import 
import 
import 


org.springframework.http.MediaType; 
org.springframework.stereotype.Component; 
org.springframework.web.reactive.function.BodyInserters; 
org.springframework.web.reactive.function.server.ServerRequest; 
org.springframework.web.reactive.function.server.ServerResponse; 
reactor.core.publisher.Mono; 


QComponent 


public 


class CityHandler { 


public Mono«ServerResponse» helloCity(ServerRequest request) { 


return ServerResponse.ok().contentType (MediaType.TEXT PLAIN) 
.body (BodyInserters.fromObject ("Hello City!")); 


9.2.3 创建 类 CityRouter 


创建 类 CityRouter, fV83 19] 9-5 所 示 。 
【 例 9-5] 创建 类 CityRouter 的 代码 示例 。 


package com.bookcode.router; 


import 
import 
import 
import 
import 
import 
import 


import 


com.bookcode.handler.CityHandler; 
org.springframework.context.annotation.Bean; 
org.springframework.context.annotation.Configuration; 
org.springframework.http.MediaType; 
org.springframework.web.reactive.function.server.RequestPredicates; 
org.springframework.web.reactive.function.server.RouterFunction; 
org.springframework.web.reactive.function.server.RouterFunctions; 


org.springframework.web.reactive.function.server.ServerResponse; 


QGConfiguration 


public 


class CityRouter { 


QBean 


public RouterFunction«ServerResponse» routeCity(CityHandler cityHandler) { 


return RouterFunctions 


. route (RequestPredicates.GET ("/hello") 
.and (RequestPredicates.accept (MediaType.TEXT 
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PLAIN) ) ， 
cityHandler::helloCity); 


9.24 ”运行 程序 


运行 程序 ， 可 以 在 控制 台中 看 到 服务 器 Netty 成 功 局 动 。 在 浏览 器 中 输入 
localhost:8080/hello， 绪 果 如 图 9-1 所 示 。 


[3 localhost:8080/hello 


€ > CŒ |O localhost:8080/hello 


Hello City! 


图 9-1 在 浏览 器 中 输入 localhost:8080/hello 后 的 结果 


93 ”实现 基于 WebFlux 的 RESTful 服务 
9.3.1 ”添加 依赖 


视频 讲解 


在 项 目 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 则 添加 Reactive Web 依赖 ， 
代码 如 例 9-3 所 示 。 


9.3.2 ”创建 类 User 


在 包 com.bookcode.entity 中 创建 类 User, RAE] 9-6 所 示 。 
【 例 9-6】 创建 类 User 的 代码 示例 。 


package com.bookcode.entity; 
public class User { 
private long id; 
private String firstname; 
private String lastname; 
private int age; 
public User() ( } 
public User (long id, String firstname, String lastname, int age) ( 
this.id - id; 
this.firstname - firstname; 
this.lastname - lastname; 
this.age - age; 
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9.3.3 创建 类 UserController 


在 com.bookcode.controller 包 中 创建 类 UserController， 代 码 如 例 9-7 所 示 。 
【 例 9-7】 创建 类 UserController 的 代码 示例 。 
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import reactor.core.publisher.Mono; 
import javax.annotation.PostConstruct; 
import java.util.HashMap; 
import java.util.Map; 
import java.util.stream.Collectors; (RestController $ 
QRequestMapping (path = "/api/user") ' 
public class UserController { 
private static final Logger logger - LoggerFactory.getLogger 
(UserController.class); 
Map«Long, User» users = new HashMapc»(); 
QPostConstruct 
public void init() throws Exception { 
users.put(Long.valueOf(1), new User(1, "Jack", "Smith", 20)); 
users.put(Long.valueOf (2), new User(2, "Peter", "Johnson", 25)); 
) 
QGGetMapping ("/index") 
public Flux«User» getAll() { 
return Flux.fromIterable (users.entrySet().stream() 
.map (entry -> entry.getValue()) 
"coaltecricollecrtors.-tobisEIL TN. 
} 
// 获 取 单 个 用 户 
@GetMapping ("/(id)") 
public Mono<User> getCustomer (@PathVariable Long id) ( 
return Mono.justOrEmpty (users.get (id)); 
) 
/ /创建 用 户 
QPostMapping ("/post") 
public Mono«ResponseEntity«String»» postUser(GRequestBody User user) ( 
users.put(user.getId(), user); 
logger.info("4EHHEd4S4S443444 POST:" + user); 
return Mono.just(new ResponseEntity«»("Post Successfully!", 
HttpStatus.CREATED)); 
} 
// 修 改 用 户 
@PutMapping ("/put/{id}") 
public Mono<ResponseEntity<User>> putCustomer (@PathVariable Long id, 
QRequestBody User user) { 
user.setId(id); 
users.put(id, user); 
System.out .println ("####t####### PUT:" + user); 
return Mono.just(new ResponseEntity«»(user, HttpStatus.CREATED)); 
) 
QDeleteMapping ("/delete/([(id)") 
public Mono«ResponseEntity«String»» deleteMethod ((CPathVariable Long id) ( 
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users.remove (id); 
return Mono.just(new ResponseEntity«»("Delete Successfully!", 
HttpStatus.ACCEPTED)); 


9.3.4 ”运行 程序 


运行 程序 ， 在 浏览 器 中 输入 localhost:8080/api/user/index， 显 示 所 有 User 实例 ， 结 果 如 
图 9-2 所 示 。 在 Postman 工具 中 显示 所 有 User 实例 的 结果 类 似 , 如 图 9-3 所 示 。 在 Postman 
工具 中 增加 firstname, lastname 都 为 z 的 User 实例 ， 结 果 如 图 9-4 所 示 。 注 意 ， 选 择 的 数 
据 格 式 是 JSON(application/json)。 增 加 User 实例 后 在 Postman 工具 中 显示 所 有 User 实例 的 
结果 如 图 9-5 所 示 。 在 浏览 器 中 显示 第 2 位 User 实例 信息 的 结果 如 图 9-6 所 示 。 


y [M localhost:8080/api/use X 


€ G | © localhost:8080/api/user/index 


[l'id": 1, "firstname": "Jack", " lastname”: "Smith", "age": 20], l'id":2, "firstname": "Peter", "lastname" :” Johnson”, " age" :25]] 


图 9-2 在 浏览 器 中 输入 localhost:8080/api/user/index 后 的 结果 


localhost:8080/api/user/index 


Preview JSON ™ 5 


wr pi-i 
"firstname": "Jack", 
"lastname": "Smith", 
"age": 20 


"id": 2, 

"firstname": "Peter", 
"lastname": "Johnson", 
"age": 25 


图 9-3 在 工具 Postman 中 显示 所 有 User 实例 的 结果 
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POST http://localhost:8080/api/user/post 


e binary 


O form-data x-www-form-urlencoded ® raw 


"firstname" : 
"lastname" : 
"age" :21 


Cookies Headers (2) Test Results 


Raw Preview 


Pretty 


1 Post Successfully! 
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JSON (application/json) v 


9-4 ”在 Postman 工具 中 增加 firstname, lastname 都 为 z 的 User 实例 后 的 结果 


localhost:8080/api/user/ index| 


Raw Preview 


"1d": 1, 
"firstname": 
"lastname": 
"age": 20 


"Jack", 
"Smith", 


"id": 2, 
"firstname": 
"lastname": 
"age": 25 


"Peter", 
"Johnson", 


"1s 3X. 
"firstname": "z", 
"lastname": "z", 
"age": 21 


9-5 


增加 User 实例 后 在 Postman 工具 中 显示 所 有 User 实例 的 结果 


218, — Spring Boot 开发 实战 一 一 微 课 视频 版 


7 [A localhost:8080/api/use 


€ > Q |O localhost:8080/api/user/2 


{1d :2, firstname” : Peter”, ” lastname”: ” Johnson”, "age": 25} 


图 9-6 EÙ Kar n 2 位 User 实例 信息 的 结果 


9.4 基于 WebFlux 访问 MongoDB 数据 库 
9.4.1 ”添加 依赖 


视频 讲解 


在 pom.xml 文件 中 <dependencles> 和 </dependencles> 之 间 添 加 Reactive Web, Reactive 
MongoDB 数据 库 和 Spring Data JPA 依赖 ， 代 人 码 如 例 9-8 Hrs 
【 例 9-8】 添加 依赖 的 代码 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-webflux«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-data-mongodb-reactive«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-test«/artifactId» 
«scope»test«/scope» 

«/dependency» 

«dependency» 
«groupId»io.projectreactor«/groupId» 
«artifactId»reactor-test«/artifactId» 
«scope»test«/scope» 

«/dependency» 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-data-jpa«/artifactId» 
«scope»test«/scope» 

«/dependency» 


9.4.2 ”安装 并 启动 MongoDB 数据 库 


Al [o] Z3 — M SX TF — FE MongoDB 数据 库 。 安 装 好 MongoDB 数据 库 之 后 ， 可 以 
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打开 Windows 命令 处 理 程序 CMD， 输 入 如 例 9-9 所 示 的 命令 局 动 MongoDB 数据 库 服务 。 
【 例 9-9】 局 动 MongoDB 数据 库 服务 的 命令 代码 示例 。 


mongod --dbpath "D:\mongodb\data\db" 


9.4.3 ”创建 类 Person ' 


在 包 com.bookcode.entity 中 创建 类 Person, (Vd ifo 9-10 所 示 。 
【 例 9-10】 创建 类 Person 的 代码 示例 。 


package com.bookcode.entity; 
import org.springframework.data.annotation.Id; 
public class Person { 
@Id 
public String id; 
private String username; 
public String getId() q 
return id; 
} 
public void setId(String id) 1 
this.id - id; 
} 
public String getUsername() { 
return username; 
} 
public void setUsername (String username) ( 


this.username - username; 


9.44 创建 接口 PersonRepository 


在 包 com.bookcode.dao 中 创建 接口 PersonRepository， 代 人 码 如 例 9-11 所 示 。 
【 例 9-11】 创建 接口 PersonRepository 的 代码 示例 。 


package com.bookcode.dao; 

import com.bookcode.entity.Person; 

import org.springframework.data.mongodb.repository.ReactiveMongoRepository; 
import org.springframework.stereotype.Repository; 

QGRepository 

public interface PersonRepository extends ReactiveMongoRepository«Person, 
String» f 

} 
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9.4.5 创建 类 PersonController 


在 包 com.bookcode.controller 中 创建 类 PersonController, RE 9j 9-12 所 示 。 
【 例 9-12】 创建 类 PersonController 的 代码 示例 。 


t package com.bookcode.controller; 
import com.bookcode.dao.PersonRepository; 
import com.bookcode.entity.Person; 
import org.reactivestreams.Publisher; 
import org.springframework.web.bind.annotation.*; 
import reactor.core.publisher.Flux; 
import reactor.core.publisher.Mono; 
QGRestController 
public class PersonController { 
private final PersonRepository personRepository; 
public PersonController(PersonRepository personRepository) ( 
this.personRepository - personRepository; 
} 
// 正 常 MVC 模式 
GGetMapping ("/") 
public String hello()( 
return "hello!"; 
} 
// 新 增 一 个 Person 
QPostMapping ("/person") 
public Mono«Void» add(8RequestBody Publisher«Person» person)( 
return personRepository.insert (person).then(); 
) 
QGGetMapping ("/person/(id)") 
public Mono«Person» getById(8PathVariable Long id)( 
return personRepository.findById(id); 
) 
QGetMapping ("/person/list") 
public Flux«Person» list()( 
return personRepository.findAll(); 
} 
QDeleteMapping ("/person/(id)]") 
public Mono«Void» delete(G8PathVariable Long id)( 
return personRepository.deleteById(id).then(); 


9.4.6 “修改 配置 文件 application.properties 


修改 配置 文件 application.properties， 代 人 码 如 例 9-13 所 示 。 
【 例 9-13】 修改 配置 文件 application.properties 的 代码 示例 。 
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spring.data.mongodb.host-localhost 
spring.data.mongodb.port-27017 


9.4.7 ”运行 程序 


— D 


启动 MongoDB 数据 库 后 ， 运 行程 序 ， 就 可 以 用 工具 Postman 来 增加 person 记录 到 数 
据 库 中 ， 如 图 9-7 所 示 。 与 此 同时 ，MongoDB 数据 库 中 test 自动 生成 了 记录 ， 结 果 在 可 视 
化 工具 Robo 3T 中 的 显示 情况 如 图 9-8 所 示 。 


POST localhost:8080/person 


Authorization Headers (1) Body e Pre-request Script Tests 


O form-data 9 x-www-form-urlencoded ® raw © binary  JSON(application/json) v 


1- ( 
m . "m 
"username" : "wst 


图 9-7 用 工具 Postman 来 增加 person 记录 


EY (8) 3 { 3 fields } 

此 | id 3 

CC username ZX 

we) class springboot.wfqs.entity.Person 
&3 (9) 1 { 3 fields ) 

Lej id 1 

“Y username zs 

we) class springboot.wfqs.entity.Person 
&3 (10) 2 ( 3 fields ) 

L&J id 2 

""| username ls 

1" class springboot.wfqs.entity.Person 
E (11) 4 { 3 fields } 

此 | id 4 

"Y username ws 


we) class springboot.wfqs.entity.Person 


图 9-8 MongoDB 的 存储 记录 在 工具 Robo 3T 中 的 显示 情况 


9.5.1 ”添加 依赖 


视频 讲解 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ， 代 人 码 如 例 9-14 
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所 示 。 


【 例 9-14】 Jf. 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-thymeleaf«/artifactId» 
</dependency> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-webflux«/artifactId» 
«/dependency» 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-data-mongodb-reactive«/artifactlId» 
«/dependency» 
«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-test«/artifactId» 
«scope»test«/scope» 
</dependency> 
<dependency> 
«groupId»io.projectreactor«/groupId» 
«artifactId»reactor-test«/artifactId» 
«scope»test«/scope» 
«/dependency» 


9.5.2 ”创建 类 City 


创建 类 City， 代 人 码 如 例 9-15 所 示 。 
【 例 9-1S】 创建 类 City 的 代码 示例 。 


package com.bookcode.entity; 
public class City ( 
private Long id; // 城 市 编号 
private Long provinceId; // 省 份 编号 
private String cityName; 
private String description; 
public Long getId() { 
return id; 
} 
public void setId(Long id) { 
this.id — id; 
} 
public Long getProvinceId() { 
return provinceId; 
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} 

public void setProvinceId(Long provinceId) 
this.provinceId = provinceId; 

} 

public String getCityName() { 
return cityName; 

} 

public void setCityName (String cityName) { 
this.cityName - cityName; 

} 

public String getDescription() ( 
return description; 


} 
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public void setDescription(String description) { 


this.description = description; 


9.5.3 ”创建 接口 CityRepository 


在 包 com.bookcode.dao 中 创建 接口 CityRepository, RE u] 9-16 所 示 。 


【 例 9-16】 创建 接口 CityRepository 的 代码 示例 。 


package com.bookcode.dao; 
import com.bookcode.entity.City; 


import org.springframework.data.mongodb.repository.ReactiveMongoRepository; 


import org.springframework.stereotype.Repository; 


import reactor.core.publisher.Mono; 


QGRepository 


public interface CityRepository extends ReactiveMongoRepository«City, Long» ( 


Mono«City» findByCityName (String cityName); 


9.5.4 创建 类 CityHandler 


创建 类 CityHandler， 代 码 如 例 9-17 所 示 。 
【 例 9-17】 创建 类 CityHandler 的 代码 示例 。 
package com.bookcode.handler; 


import com.bookcode.dao.CityRepository; 


import com.bookcode.entity.City; 


import org.springframework.beans.factory.annotation.Autowired; 


import org.springframework.stereotype.Component; 


import reactor.core.publisher.Flux; 


import reactor.core.publisher.Mono; 
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QComponent 
public class CityHandler ( 
private final CityRepository cityRepository; 


QGAutowired 
à public CityHandler(CityRepository cityRepository) ( 
+ this.cityRepository = cityRepository; 


} 
public Mono<City> save (City city) { 
return cityRepository.save (city); 
} 
public Mono<City> findCityById (Long id) { 
return cityRepository.findById (id); 
} 
public Flux«City» findAllCity() 1 
return cityRepository.findAll(); 
} 
public Mono«City» modifyCity(City city) ( 
return cityRepository.save(city); 
} 
public Mono<Long> deleteCity(Long id) { 
cityRepository.deleteById (id); 
return Mono.create(cityMonoSink -> cityMonoSink.success (id)); 
} 
public Mono«City» getByCityName (String cityName) ( 
return cityRepository.findByCityName (cityName); 


9.5.5 ”创建 类 CityController 


创建 类 CityController， 其 代码 如 例 9-18 所 示 。 
【 例 9-18】 创建 类 CityController 的 代码 示例 。 


package com.bookcode.controller; 

import com.bookcode.entity.City; 

import com.bookcode.handler.CityHandler; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 
import org.springframework.ui.Model; 

import org.springframework.web.bind.annotation.*; 
import reactor.core.publisher.Flux; 

import reactor.core.publisher.Mono; 

QGController 

QGRequestMapping(value = "/city") 

public class CityController { 
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QGAutowired 

private CityHandler cityHandler; 

QGGetMapping (value = "/{id}") 

QResponseBody 

public Mono«City» findCityById(8PathVariable("id") Long id) { 
return cityHandler.findCityById(id); 

} 

QGetMapping () 

QResponseBody 

public Flux«City» findAllCity() ( 
return cityHandler.findAllCity(); 

} 

QPostMapping() 

QGResponseBody 

public Mono«City» saveCity(8RequestBody City city) ( 
return cityHandler.save(city); 

} 

QPutMapping () 

QResponseBody 

public Mono«City» modifyCity(8RequestBody City city) ( 
return cityHandler.modifyCity (city); 

} 

@DeleteMapping (value = "/(id)") 

QResponseBody 

public Mono«Long» deleteCity(GPathVariable("id") Long id) { 
return cityHandler.deleteCity (id); 

} 

private static final String CITY LIST PATH NAME - "cityList"; 

private static final String CITY PATH NAME - "city"; 

QGGetMapping ("/page/1list") 

public String listPage(final Model model) ( 
final Flux«City» cityFluxList - cityHandler.findAllCity(); 
model.addAttribute("cityList", cityFluxList); 
return CITY LIST PATH NAME; 

} 

QGetMapping ("/getByName") 

public String getByCityName (final Model model, 


QGRequestParam(value-"cityName",required = false, defaultValue -"xuzhou") 


String cityName) { 


final Mono«City» city = cityHandler.getByCityName (cityName); 


model.addAttribute("city", city); 
return CITY PATH NAME; 
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9.5.6 ”创建 文件 cityList.html 


在 src/main/resources/templates 目录 下 创建 文件 cityList.html， 代 人 码 如 例 9-19 所 示 。 
【 例 9-19】 创建 文件 cityList.html 的 代码 示 例 。 


¢ 
t <!DOCTYPE html> 
<html lang="zh-CN" xmlns:th="http://www.thymeleaf.org"> 
<head> 
<meta charset="UTF-8"/> 
<title> 城 市 列表 </title> 
</head> 
<body> 
<div> 
<table> 
<legend> 
<strong> 城 市 列表 </strong> 
</legend> 
<thead> 
"rr 
<th> 城 市 编号 </th> 
<th> 省 份 编号 </th> 
<th> 名 称 </th> 
<th> 摘 述 </th> 
CITE? 
</thead> 
<tbody> 


«tr th:each-"city : $(cityList)"» 
«td th:text-"$[city.id]"»«/td» 
«td th:text-"$(city.provinceId)"»«/td» 
«td th:text-"$(city.cityNamej]"»«/td» 
«td th:text-"$(city.descriptionj)"»«/td» 
CSFEPS 
«/tbody» 
«/table» 
«/div» 
«/body» 
«/html» 


9.5.7 ”创建 文件 city.html 


在 src/main/resources/templates 目录 下 创建 文件 city.html， 代 人 码 如 例 9-20 所 示 。 
【 例 9-20】 创建 文件 city.html 的 代 人 码 示例 。 

«!DOCTYPE html» 

«html lang-"zh-CN" xmlns:th-"http://www.thymeleaf.org"» 


<head> 
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«meta charset-"UTF-8"/» 
«title»JWilic/title» 


</head> 

<body> 

<div> 
<table> 


<legend> 
<strong> 城 市 单个 查询 </strong> 
«/legend» 
«tbody» 
«td th:text-"$(city.id)"»«/td» 
«td th:text-"$(city.provinceIdj)"»«/td» 
«td th:text-"$(city.cityName)"»«/td» 
«td th:text-"$(city.description|]"»«/td» 
«/tbody» 


«/table» 
«/div» 
«/body» 
«/html» 


9.5.8 ”运行 程序 


修改 配置 文件 appllicatton.properties， 代 码 如 例 9-13 所 示 。 


运行 程序 后 ， 局 动 MongoDB， 在 浏览 器 中 输入 localhost:8080/city/page/list 后 ， 在 浏览 
器 中 显示 所 有 city 记录 信息 ， 结 果 如 图 9-9 所 示 。 为 了 利用 cityName ÆW xuzhou. RIN) 
信息 ， 在 浏览 器 中 输入 http:Wlocalhost:8080/citygetByYName?cityName=xuzhou， 结 果 如 


图 9-10 所 示 。 


城市 列表 


E 2 C | © localhost:8080/city/page/list 


城市 列表 

城市 编号 eme en ” 描述 
1 2 xuzhou JiangSu 
2 2 nanjing JiangSu 
3 2 suzhou JiangSu 


图 9-9 在 浏览 器 中 输入 localhost:8080/city/page!/list 后 的 结果 
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"ET = 


€ C | © localhost:8080/city/getByName?cityName-xuzhou 


城市 单个 查询 


1 2 xuzhou JiangSu 


图 9-10 在 浏览 器 中 输入 http://ocalhost:8080/city/getByName?cityName-xuzhou 后 的 结果 


9.6 基于 WebFlux 访问 Redis 数据 库 Et 


Beg UH 
Redis 是 一 种 可 以 持久 存储 的 缓存 系统 ,是 用 C 语言 编写 、 支持 网 络 、 Deest 
可 基于 内 存 并 可 持久 化 的 日 志 型 Key-Value 〈 键 - 值 ) 数据 库 ， 并 提供 多 种 视频 讲解 
语言 的 API。Redis 文 持 存 储 的 值 类 型 很 多 ， 包 括 字 从 串 、 链 表 、 集 合 、 有 序 集合 和 哈 希 类 
型 。 在 此 基础 上 ，Redis 文 持 各 种 不 同方 式 的 排序 。 为 了 保证 效率 ， 数 据 都 是 绥 存 在 内 存 中 。 
它 提供 了 Java、C/C++、Python 等 客户 端 ， 使 用 很 方便 。Redis 文 持 主 从 同步 ， 从 服务 器 上 
的 数据 可 以 和 主 服务 器 上 的 数据 同步 。 同 步 对 读 取 操作 的 可 扩展 性 和 数据 见 余 很 有 帮助 。 


9.6.1 添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ， 代 人 码 如 例 9-21 
Wt. 
【 例 9-21】 添加 依赖 的 代码 示例 。 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-data-redis-reactive«/artifactId» 

«/dependency» 

«dependency» 

«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-webflux«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-test«/artifactId» 
«scope»test«/scope» 

</dependency> 

<dependency> 
«groupId»io.projectreactor«/groupId» 
«artifactlId»reactor-test«/artifactId» 
«scope»test«/scope» 

«/dependency» 
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9.6.2 ”创建 类 Coffee 


在 包 com.bookcode.entity 中 创建 类 Coffee， 代 人 码 如 例 9-22 所 示 。 
【 例 9-22】 创建 类 Coffee 的 代码 示例 。 


package com.bookcode.entity; t 
public class Coffee { 
private String id; 
private String name; 
public String getId() { 
return id; 
} 
public void setId(String id) { 
this.id - id; 
) 
public String getName() { 
return name; 
} 
public void setName (String name) ( 
this.name - name; 
} 
public Coffee() ( ] 
public Coffee(String id,String name)( 
this.id-id; 


this.name-name; 


9.6.3 ”创建 类 CoffeeConfiguration 


在 包 com.bookcode.config 中 创建 类 CoffeeConfiguration， 代 人 码 如 例 9-23 所 示 。 
【 例 9-23】 创建 类 CoffeeConfiguration 的 代码 示例 。 


package com.bookcode.config; 

import com.bookcode.entity.Coffee; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 

import org.springframework.data.redis.connection.ReactiveRedisConnectionFactory; 
import org.springframework.data.redis.core.ReactiveRedisOperations; 
import org.springframework.data.redis.core.ReactiveRedisTemplate; 
import org.springframework.data.redis.serializer.Jackson2JsonRedisSerializer; 
import org.springframework.data.redis.serializer.RedisSerializationContext; 
import org.springframework.data.redis.serializer.StringRedisSerializer; 
QGConfiguration // 配 置 类 
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public class CoffeeConfiguration { 
QBean 
ReactiveRedisOperations«String, Coffee» redisOperations 
(ReactiveRedisConnectionFactory factory) { 
¢ //Redis 没有 表 结 构 的 概念 ， 需 要 使 用 JSON 格式 的 文本 作为 Redis 和 Java 普通 对 象 互相 交换 
// 数 据 的 存储 格式 
//RedisTemplate 初始 化 
// 为 了 正确 调用 RedisTemplate， 必 须 对 其 进行 一 些 初始 化 工作 ， 即 主要 对 它 存 取 的 字符 串 进 
// 行 一 个 JSON 格式 的 系列 化 初始 配置 
Jackson2JsonRedisSerializer<Coffee> serializer = new 
Jackson2JgsonRedisSerializer«» (Coffee.class); 
RedisSerializationContext.RedisSerializationContextBuilder«String, 
Coffee» builder = RedisSerializationContext.newSerializationContext (new 
StringRedisSerializer()); 
RedisSerializationContext«String, Coffee» context - builder.value 
(serializer).build(í); 


return new ReactiveRedisTemplate«»(factory, context); 


9.6.4 创建 类 CoffeeLoader 


在 包 com.bookcode.loader 中 创建 类 CoffeeLoader， 人 代码 如 例 9-24 所 示 。 
【 例 9-24】 创建 类 CoffeeLoader 的 代码 示例 。 


package com.bookcode.loader; 
import com.bookcode.entity.Coffee; 
import org.springframework.data.redis.connection.ReactiveRedi sConnectionFactory; 
import org.springframework.data.redis.core.ReactiveRedisOperations; 
import org.springframework.stereotype.Component; 
import reactor.core.publisher.Flux; 
import javax.annotation.PostConstruct; 
import java.util.UUID; 
QGComponent // 组 件 
public class CoffeeLoader { 
private final ReactiveRedisConnectionFactory factory; 
private final ReactiveRedisOperations«String, Coffee» coffeeOps; 
public CoffeeLoader (ReactiveRedisConnectionFactory factory, 
ReactiveRedisOperations«String, Coffee» coffeeOps) { 
this.factory - factory; 
this.coffeeOps - coffeeOps; } 
QPostConstruct 
public void loadData() { 
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factory.getReactiveConnection () . serverCommands () . £1ushA11 () .thenMany ( 

Flux.just("Jet Black Redis", "Darth Redis", "Black Alert 

Redis") 
-map (name -> new Coffee (UUID.randomUUID().toString(), 
name) ) $ 
-flatMap (coffee -> coffeeOps.opsForValue().set 
(coffee.getId(), coffee))) 

.thenMany (cof feeOps.keys ("x") 
.flatMap (coffeeOps.opsForValue()::get)) 


. subscribe (System.out::println); 


9.6.5 ”运行 程序 


运行 程序 ,可 以 在 工具 Redis Desktop Manager 中 观察 到 增加 了 三 条 记录 ,结果 如 图 9-11 
所 示 。 
li Redis Desktop Manager 0.9.3.817 
O 连接 到 Redis 服务 器 “| F x 
a testredis P testredis::db0:...da-4c4c3d77ba43 X 
vbo (3) 


STRING: |6295b75f-369c-4cdb-a9da-4c4c3d77ba43 


P 6295b75£-369c-4cdb-a9da-4d 3d fly ba 43 
P 7f8afd4c-£7£1-40e4-ad80-9a597e896016 


{ 
P d8b03380-9107-433f-8dd2-4b2ebc2799bdqd "id": "6295b75f-369c-4cdb-a9da-4c4c3d77ba43" , 
"name": "Black Alert Redis" 


» Qi (D } 


Value: 


图 9-11 在 工具 Redis Desktop Manager 中 显示 的 结果 


9.6.6 ”创建 类 City 


在 包 com.bookcode.entity 中 创建 类 City， 代 人 码 如 例 9-25 所 示 。 
【 例 9-25】 创建 类 City 的 代码 示例 。 


package com.bookcode.entity; 
import org.springframework.data.annotation.Id; 
import java.io.Serializable; 
public class City implements Serializable { 
QId 
private Long id; 
private Long provinceId; 
private String cityName; 


private String description; 
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@GetMapping (value = "/{id}") 
public Mono«City» findCityById(@PathVariable ("id") Long id) { 
String key = "city " + id; 
ValueOperations«String, City» operations = redisTemplate.opsForValue|(); 
boolean hasKey = redisTemplate.hasKey (key); $ 
City city = operations.get (key); ' 
if (!hasKey) ( 
return Mono.create(monoSink -» monoSink.success (null)); 
} 
return Mono.create(monoSink -> monoSink.success(city)); 
} 
QPostMapping () 
public Mono«City» saveCity(8RequestBody City city) ( 
String key = "city " + city.getId(); 
ValueOperations«String, City» operations - redisTemplate. 
opsForValue(); 
operations.set(key, city, 60, TimeUnit.SECONDS); 
return Mono.create(monoSink -> monoSink.success(city)); 
} 
@DeleteMapping (value = "/(id)") 
public Mono<Long> deleteCity(@PathVariable ("id") Long id) { 
String key - "city " + id; 
boolean hasKey = redisTemplate.hasKey (key); 
if (hasKey) { 
redisTemplate.delete (key); 
) 
return Mono.create(monoSink -» monoSink.success(id)); 


9.6.8 ”修改 配置 文件 application.properties 


修改 配置 文件 application.properties， 代 人 码 如 例 9-27 所 示 。 
【 例 9-27】 修改 配置 文件 application.properties 的 代码 示例 。 


# 设 置 Redis 数据 库 信 息 
spring.redis.host-localhost 


spring.redis.port-6379 


9.6.9 ”运行 程序 


运行 程序 ， 在 工具 Postman 中 添加 一 条 城市 信息 记录 ， 结 果 如 图 9-12 MR. ETH 
Postman 中 获取 第 2 条 城市 信息 记录 ， 结 果 如 图 9-13 所 示 。 
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POST v localhost:8080/city 


O form-data ® x-www-form-urlencoded ® raw O binary JSON (application/json) v 


1 "id":1,"provinceId":2,"cityName":"NanJin","description":"North of Jiangsu" y} 


Cookies Headers (2) Test Results 
Raw Preview JSON v 5 


"id": 1, 

"provinceId": 2, 

"cityName": "NanJin", 
"description": "North of Jiangsu" 


图 9-12 在 工具 Postman 中 添加 一 条 城市 信息 记录 的 结果 


GET "v localhost:8080/city/2 


Params Authorization Headers (1) Pre-request 
KEY VALUE 


Key Value 


Body Cookies Headers (2 Test Results 


Preview JSON Y 


"d": 2, 

"provinceId": 25, 

"cityName": "H", 
"description": "地 处 江苏 北部 ” 


图 9-13 在 工具 Postman 中 获取 第 2 条 城市 信息 记录 的 结果 


9.6.10 ”创建 类 CityWebFluxReactiveController 


创建 类 CityWebFluxReactiveController， 代 码 如 例 9-28 所 示 ， 其 功能 与 例 9-26 相同 。 
【 例 9-28】 创建 类 CityWebFluxReactiveController 的 代码 示例 。 


package com.bookcode.controller; 

import com.bookcode.entity.City; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.data.redis.core.ReactiveRedisTemplate; 
import org.springframework.data.redis.core.ReactiveValueOperations; 
import org.springframework.web.bind.annotation.*; 


import reactor.core.publisher.Mono; 
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@RestController 
@RequestMapping (value = "/city2") 
public class CityWebFluxReactiveController { 
QAutowired 
private ReactiveRedisTemplate reactiveRedisTemplate; 
QGetMapping (value = "/{id}") 
public Mono«City» findCityById(8PathVariable("id") Long id) { 
String key = "city " + id; 
ReactiveValueOperations«String, City» operations = 
reactiveRedisTemplate.opsForValue(); 
Mono«City» city - operations.get (key); 
return city; 
} 
QPostMapping 
public Mono«City» saveCity(8RequestBody City city) ( 
String key = "city " + city.getId(); 
ReactiveValueOperations«String, City» operations - 
reactiveRedisTemplate.opsForValue(); 
return operations.getAndSet(key, city); 
} 
QGDeleteMapping (value = "/{id}") 
public Mono<Long> deleteCity(GPathVariable("id") Long id) ( 
String key = "city " + id; 


return reactiveRedisTemplate.delete (key); 


9.7 基于 WebFlux 使 用 WebSocket 


双 工 通信 。 在 WebSocket 中 ， 浏 览 耸 和 服务 需 只 需要 完成 一 次 握手 ， 束 可 视频 讲解 
以 创建 持久 性 的 连接 ,浏览 右 和 服务 俘 之 间 束 形成 了 一 条 快速 通道 。 两 者 之 间 融 直接 可 以 互 
相传 送 数 据 。 很 多 网 站 为 了 实现 推送 技术 所 用 的 技术 部 是 Ajax 轮 询 。 轮 询 是 在 特定 的 的 时 
间 间 阳 (如 1 秒 )， 由 客户 器 的 浏览 费 问 服务 占 发 出 HTTP 请 求 ， 然 后 由 服务 占 返 回 最 新 的 
数据 给 浏览 右 。 这 种 模式 有 明显 的 缺点 ， 即 浏览 耸 要 不 断 地 回 服务 硕 发 出 请 求 。 然 而 ，HITIP 
请 求 可 能 包含 较 长 的 尖 部 ， 真 正 有 效 的 数据 可 能 只 是 很 小 的 一 部 分 ， 这样 会 浪费 很 多 的 市 宽 
等 资源 。 用 WebSocket 能 更 好 地 区 省 服务 需 资 源 和 市 宽 ， 并 且 能 够 更 实时 地 进行 通信 。 


9.7.1 添加 依赖 


在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 间 添 加 依赖 ， 代 人 码 如 例 9-29 
所 示 。 
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【 例 9-29】 添加 依赖 的 代码 示例 。 


«dependency» 

«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-webflux«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-test«/artifactId» 
«scope»test«/scope» 

«/dependency» 

«dependency» 
«groupId»io.projectreactor«/groupId» 
«artifactId»reactor-test«/artifactId» 
«scope»test«/scope» 

«/dependency» 


9.7.2 ”创建 类 EchoHandler 


在 包 com.bookcode..handler 中 创建 类 EchoHandler， 代 码 如 例 9-30 所 示 。 
【 例 9-30】 创建 类 EchoHandler 的 代码 示例 。 


package com.bookcode.Handler; 
import org.springframework.stereotype.Component; 
import org.springframework.web.reactive.socket.WebSocketHandler; 
import org.springframework.web.reactive.socket.WebSocketSession; 
import reactor.core.publisher.Mono; 
QGComponent 
public class EchoHandler implements WebSocketHandler { 

QOverride 

public Mono«Void» handle (final WebSocketSession session) { 

return session.send( 
session.receive() 
.map(msg -» session.textMessage( 
"服务 端 返回 : JH, "--msg.getPayloadAsText ()))); 


9.7.3 创建 类 WebSocketConfiguration 


在 com.bookcode.config 包 中 创建 类 WebSocketConfiguration， 代 码 如 例 9-31 所 示 。 
【 例 9-31] 创建 类 WebSocketConfiguration 的 代码 示例 。 


package com.bookcode.config; 


import com.bookcode.Handler.EchoHandler; 


import 
import 
import 
import 
import 
import 
import 


import 
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org.springframework.beans.factory.annotation.Autowired; 
org.springframework.context.annotation.Bean; 
org.springframework.context.annotation.Configuration; 
org.springframework.core.Ordered; 
org.springframework.web.reactive.HandlerMapping; é 
org.springframework.web.reactive.handler.SimpleUrlHandlerMapping; t 
org.springframework.web.reactive.socket.WebSocketHandler; 


org.springframework.web.reactive.socket.server.support. 


WebSocketHandlerAdapter; 


import 
import 


java.util.HashMap; 
java.util.Map; 


QGConfiguration 


public 


class WebSocketConfiguration ( 


QAutowired 


Bean 


public HandlerMapping webSocketMapping(final EchoHandler echoHandler) { 


} 


final Map«String, WebSocketHandler» map = new HashMap<> () ; 


map.put("/echo", echoHandler); 


final SimpleUrlHandlerMapping mapping - new 


SimpleUrlHandlerMapping!(); 
mapping.setOrder (Ordered.HIGHEST PRECEDENCE); 
mapping.setUrlMap (map); 


return mapping; 


@Bean 
public WebSocketHandlerAdapter handlerAdapter() { 


9.7.4 


return new WebSocketHandlerAdapter(); 


创建 类 WSClient 


在 test/Java/com.bookcode 目录 下 创建 类 WSClient， 人 代码 如 例 9-32 所 示 。 
【 例 9-32】 创建 类 WSClient 的 代码 示例 。 


package com.bookcode; 


import 
import 


org.springframework.web.reactive.socket.WebSocketMessage; 
org.springframework.web.reactive.socket.client. 


ReactorNettyWebSocketClient; 


import 
import 
import 
import 
public 


org.springframework.web.reactive.socket.client.WebSocketClient; 
reactor.core.publisher.Flux; 

java.net.URI; 

java.time.Duration; 

class WSClient f 


public static void main(final String[] args) ( 
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final WebSocketClient client = new ReactorNettyWebSocketClient(); 
client.execute (URI.create("ws://localhost:8080/echo"), session -> 
session.send(Flux.just(session.textMessage (" 你 好 ") ) ) 


.thenMany (session.receive() .take (1) .map (WebSocketMessage:: 


getPayloadAsText)) 
.-doonNext (System.out::println) 
.then()) 
.block(Duration.ofMillis (5000)); 


9.7.5 创建 文件 websocket-client.html 


在 resources/static 目录 下 创建 文件 websocket-clienthtml, RI W 9-33 所 示 。 
【 例 9-33】 创建 文件 websocket-client.html 的 代码 示例 。 


<!DOCTYPE html» 
«html lang-"en"» 
«head» 
«meta charset-"UTF-8"/» 
«title»Client WebSocket«/title» 
</head> 
<body> 
<div class="chat"></div> 
«script» 
var clientWebSocket = new WebSocket ("ws://localhost:8080/echo"); 
clientWebSocket.onopen = function () ( 
console.log("clientWebSocket.onopen", clientWebSocket); 
console.log("clientWebSocket.readyState", "websocketstatus"); 
clientWebSocket.send("Í[füf! "); 
} 
clientWebSocket.onclose = function (error) ( 
console.log("clientWebSocket.onclose", clientWebSocket, error); 
events (" 聊 天 会 话 关闭 ! "); 
} 


function events(responseEvent) { 


document.querySelector(".chat").innerHTML += responseEvent + "«br»"; 


) 
CISUCPIDES 
«/body» 
«/html» 


9.7.6 ”运行 程序 


先 运 行 服务 器 端 主 程序 ， 再 运行 客户 端 WSClient， 正 常 运行 后 控制 台 的 主要 输出 结果 
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如 图 9-14 所 示 。 程 序 正常 运行 时 ， 在 浏览 器 中 输入 localhost:8080/websocket-client.html, 
结果 如 图 9-15 所 示 。 关 闭 程序 后 浏览 器 中 的 输出 结果 如 图 9-16 所 示 。 


服务 端 返回 : 小 明 ， 你 好 


9-14 ”控制 台中 主要 输出 结果 


[3 Client WebSocket x W—3 


€ È- | Q localhost:8080/websocket-client.html 


聊天 会 证 打开 ! 


9-15 在 浏览 器 中 输入 localhost:8080/websocket-client.html 后 的 结果 


口 Client WebSocket xU i 


Q | © localhost:8080/websocket-client.html 


聊天 会 话 打 开 ! 
聊天 会 话 关闭 ! 


9-16 关闭 程序 后 浏览 器 中 的 输出 结果 


1. 简 述 对 WebFlux 的 理解 。 

2. RX] WebFlux 编程 模型 的 理解 。 

3. 简 述 对 Redis 的 理解 。 

4. 人 简 述 对 WebSocket 的 理解 。 

实验 题 

实现 WebFlux 的 简单 应 用 。 

实现 基于 WebFlux 的 RESTful 服务 。 
实现 基于 WebFlux 访问 MongoDB 数据 库 。 
实现 基于 WebFlux 使 用 Thymeleaf. 
实现 基于 WebFlux 访问 Redis 数据 库 。 
实现 基于 WebFlux 使 用 WebSocket。 


QN Un 上 一 


本 章 结 合 一 个 案例 说 明 Spring Boot 的 开发 过 程 。 
1 


案例 分 析 


10. 
10.1.1. 主要 界面 


用 户 登 录 界 面 如 图 10-1 所 示 ; 用 户 注册 界面 如 图 10-2 所 示 ; 用 户 登 录 后 的 主 界面 如 
图 10-3 所 示 ; 增加 新 的 课程 类 型 界面 如 图 10-4 所 示 ; 管理 课程 类 型 界面 如 图 10-5 所 示 ; 
增加 新 的 谍 程 界面 如 图 10-6 所 示 ; 管理 课程 界面 如 图 10-7 所 示 ; 用 户 退 出 系统 前 的 提示 
界面 网 10-8 所 示 。 


© Spring Boot 
课程 管理 系统 用 户 登 录 


用 户 姓名 : 


登录 密码 : | 请 输入 密码 |] 


| 登录 | 注册 


© 2018 参考 网 上 实例 | 
当前 时 间 为 2018 年 10 月 9 日 17:40 星期 二 


图 10-1 用 户 登 录 界 面 
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C | © localhost:8080/security/register 


用 户 注册 ， 请 注意 格式 
用 户 名 : 


< De 


10-2 用户 注 册 界 面 


课程 管理 系统 © 探 作 员 :a Oaa 


i 欢迎 使 用 本 系统 


© 2018 fi Excel 
saajia 2018 年 10 月 5 日 17:42 呈 期 二 


10-3 用户 登 录 后 的 主 界面 


课程 管理 系统 OU 


课程 类 型 名 称 : 


图 10-4 增加 新 的 课程 类 型 界面 
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SsESERRRER, 
SIDIITTDM 


OIDI ou 上 iiwiN in 


夫 9 条 , 当前 显示 1-9 条 , 1/10 | | 到 m 


10-5. 管理 课程 类 型 界面 


课程 管理 系统 © 探 作 员 :a Q.. 


新 增 课程 类 型 


: 图 开放 公 选 ” 生 医 不 开放 ”向 停止 授 谋 
: 国 大 三 以 上 C3E£85828053 目 非 本 专业 字 生 Lone 


© 2018 £3 Ex 
当前 时 间 为 2018510H9H 17:44 呈 期 二 


10-6 ”增加 新 的 读 程 界面 


Struts+Spring+Hibernate 


SpringMVC 


SSM 开 发 甚而 


HSE, 当前 显示 1-4 笠 , 第 1/2 页 | A xml | 到 nmi | 


€ 2018 $9 Exi 
当前 时 间 为 2018 年 10 月 9 日 17:44 呈 期 二 


10-7 管理 课程 界面 
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localhost:8080 显示 


您 真 的 要 高 开 系 统 吗 ? 操作 员 :a x M 


图 10-8 用户 退 出 系统 前 的 提示 界面 


10.1.2 ”主要 功能 与 数据 库 介绍 


系统 的 主要 功能 包括 用户 登 录 、 用 户 注 册 、 增 加 课程 类 型 、 管 理 课程 类 型 (修改 和 删 
除 课 程 类 型 )、 增 加 课程 、 管 理 课 程 ( 修 改 和 删除 课程 )、 用 户 退 出 系统 等 功能 。 为 了 更 好 
地 实现 系统 界面 , 需要 用 到 页 和 面 片 段 的 定义 和 使 用 功能 。 为 了 更 好 地 显示 诬 程 类 型 和 课程 ， 
需要 用 到 分 页 功能 。 

为 了 存储 数据 ， 需 要 用 到 数据 库 。 本 案例 中 用 的 数据 库 是 MySQL 数据 库 。 用 到 的 主 
要 的 表 有 用 户 表 tbl users、 课 程 表 tbl course、 课 程 类 型 表 tbl course type。 创建 这 些 表 和 
回 表 中 插入 记录 的 SQL 语句 如 例 10-1 所 示 。 

【 例 10-1】 创建 表 和 癌 表 中 插入 记录 SQL 语句 的 代码 示例 。 


create table tbl course( 

course no varchar(50) primary key, 

course name varchar(100) not null, 

course hours int not null, 

type id int not null, 

course status varchar(1) not null, 

course reqs varchar(20) not null, 

course point decimal(3,1), 

course memo varchar(1000), 

course textbook pic mediumblob, 

constraint FK COURSE TYPE FOREIGN KEY (type id) references tbl course 

type(type id) 
); 
create table tbl course type( 

type id int primary key auto increment, 

type name varchar(30) not null 
); 
insert into tbl course type(type name) values (' 专 业 必 修 '); 
insert into tbl course type (type name) values (' 专 业 任 选 ') ; 
insert into tbl course type (type name) values (' 校 选课 ' ) ; 
insert into tbl course type (type name) values (' 专 家 讲座 ' ) ; 
create table tbl users( 

user no varchar(20) primary key, 

user pwd  varchar(1000) not null, 


user name varchar(100) not null 
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I: 
insert into tbl users valnes( 000101", 123456. "I 
insert into tbl users values('000102',"'123456', '9K—"'); 


alter table tbl course add course textbook pic mediumblob; 


10.2 ”案例 实现 
10.2.1 ”添加 依赖 


视频 讲解 
在 pom.xml 文件 中 <dependencies> 和 </dependencies> 之 则 添加 依赖 ， 代 人 码 如 例 10-2 
Bra. 
[5110-2] JW 


«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter«/artifactId» 

«/dependency» 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-test«/artifactId» 
«scope»test«/scope» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-aop«/artifactId» 
«exclusions» 

«exclusion» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-logging«/artifactId» 

«/exclusion» 

«/exclusions» 

«/dependency» 

«dependency» 

«groupId»org.slf4j«/groupId» 
«artifactId»slf4j-api«/artifactId» 

«/dependency» 

«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 

</dependency> 

<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-devtools«/artifactId» 

</dependency> 
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«dependency» 

«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-thymeleaf«/artifactId» 

«/dependency» 

«dependency» $ 
«groupId»javax.persistence«/groupId» 
«artifactId»persistence-api«/artifactId» 
«version»1.0«/version» 

«/dependency» 

«dependency» 

«groupId»org.springframework«/groupId» 
«artifactId»spring-context-support«/artifactId» 
</dependency> 

<dependency> 
<groupId>org.springframework</groupId> 
«artifactId»spring-tx«/artifactId» 

«/dependency» 

«dependency» 

«groupId»5tk.mybatis«/groupId» 
«artifactId»mapper-spring-boot-starter«/artifactId» 
«version»2.0.4«/version» 

«/dependency» 

«dependency» 

«groupId»com.github.pagehelper«c«/groupId» 
«artifactId»pagehelper-spring-boot-starter«/artifactId» 
«version»1.2.6«/version» 

</dependency> 

<dependency> 
«groupId»org.apache.commons«/groupId» 
«artifactId»commons-lang3«/artifactId» 

«/dependency» 

«dependency» 

«grouplId»mysql«/groupId» 
«artifactId»mysql-connector-java«/artifactId» 

«/dependency» 

«dependency» 

«groupId»com.alibaba«/groupId» 
«artifactId»druid-spring-boot-starter«/artifactId» 
«/dependency» 


10.2.2 ”创建 类 User. CourseType 和 Course 


实体 类 User 的 代码 如 例 10-3 所 示 。 
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【 例 10-3】 实体 类 User 的 代 人 码 示 例 。 


package xiao.ze.demo.entity; 
import org.springframework.stereotype.Component; 
import javax.persistence.*; 
import javax.validation.constraints.NotEmpty; 
import java.io.Serializable; 
QGComponent 
QTable(name-"tbl users") 
public class User implements Serializable( 
@Id 
QGGeneratedValue(strategy = GenerationType.IDENTITY) 
@Column (name-"user no") 
private int userNo; 
QColumn (name-"user name") 
private String userName; 
private String userPwd; 
public int getUserNo() { 
return userNo; 
} 
public void setUserNo(int userNo) ( 
this.userNo - userNo; 
} 
public String getUserName() { 
return userName; 
} 
public void setUserName (String userName) ( 
this.userName - userName; 
} 
public String getUserPwd() ( 
return userPwd; 
} 
public void setUserPwd(String userPwd) ( 
this.userPwd - userPwd; 


实体 类 CourseType 的 代码 如 例 10-4 rz. 
【 例 10-4】 实体 类 CourseType 的 代 但 示例 。 


package xiao.ze.demo.entity; 

import org.springframework.stereotype.Component; 
import javax.persistence.GeneratedValue; 

import javax.persistence.GenerationType; 

import javax.persistence.Id; 

import javax.persistence.Table; 


import java.io.Serializable; 
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QComponent 
QGTable(name-"tbl course type") 
public class CourseType implements Serializable( 


@Id 
@GeneratedValue (strategy = GenerationType.IDENTITY) $ 
private Integer typeId; J 


private String typeName; 

public Integer getTypeId() { 
return typeId; 

} 

public void setTypeId(Integer typeId) ( 
this.typeld - typeId; 

} 

public String getTypeName() { 
return typeName; 

} 

public void setTypeName (String typeName) ( 
this.typeName - typeName; 

} 

QOverride 

public String toString() ( 
return "CourseType [typeld-" + typeld + ", LypeName-" + typeName + "]"; 


实体 类 Course 的 代码 如 例 10-5 所 示 。 
【 例 10-5】 实体 类 Course 的 代码 示例 。 


package xiao.ze.demo.entity; 
import org.springframework.stereotype.Component; 
import java.io.Serializable; 
QComponent 
public class Course implements Serializable( 
private String courseNo; 
private String courseName; 
private Integer courseHours; 
private String courseStatus; 
private Double coursePoint; 
private String[] courseReqs; 
private String reqs; 
private String courseMemo; 
private byte[] courseTextbookPic;  // 教 材 封面 
private CourseType courseType; 
public String getCourseNo() { 
return courseNo; 
} 
public void setCourseNo(String courseNo) ( 
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} 
public void setCourseMemo (String courseMemo) { 


this.courseMemo - courseMemo; 

} 

public byte[] getCourseTextbookPic() ( $ 
return courseTextbookPic; 

} 

public void setCourseTextbookPic(byte[] courseTextbookPic) { 
this.courseTextbookPic - courseTextbookPic; 

} 

public String getReqs() { 
return reqs; 

} 

public void setReqs (String reqs) ( 
this.reqs - reqs; 


this.courseReqs = this.reqs.split("NW|"); 


10.2.3 创建 Service 接口 


接口 UserService 的 代码 如 例 10-6 所 示 。 
【 例 10-6】 接口 UserService 的 代码 示例 。 


package xiao.ze.demo.service; 
import xiao.ze.demo.entity.User; 
import java.util.List; 
public interface UserService { 
List«User» loadUserByUserName (String userName); 


void addUser (User user); 


接口 CourseTypeService 的 代码 如 例 10-7 所 示 。 
【 例 10-7] 接口 CourseTypeService 的 代码 示例 。 


package xiao.ze.demo.service; 

import xiao.ze.demo.entity.CourseType; 

import java.util.List; 

public interface CourseTypeService { 
void addCourseType (CourseType courseType); 
void removeCourseType (Integer typeId); 
void updateCourseType (CourseType courseType); 
CourseType getCourseTypeById(Integer typeId); 
List«CourseType» loadAl11(); 
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接口 CourseService 的 代码 如 例 10-8 所 示 。 
【 例 10-8] 接口 CourseService 的 代码 示例 。 


package xiao.ze.demo.service; 
$ import xiao.ze.demo.entity.Course; 
à import xiao.ze.demo.utils.CourseQueryHelper; 
import java.util.List; 
public interface CourseService { 
void addCourse(Course course); 
boolean removeCourseByNo(String courseNo); 
void updateCourse (Course course); 
Course loadCourseByNo(String courseNo); 
List«Course» loadScopedCourses (CourseQueryHelper helper); 


byte[] getTextbookPic(String courseNo); 


10.2.4 创建 Service 接口 实现 类 


接口 UserService 实现 类 UserServiceImpl 的 代码 如 例 10-9 所 示 。 
【 例 10-9】 接口 UserService 实现 类 UserServiceImpl 的 代码 示例 。 


package xiao.ze.demo.service.impl; 
import org.springframework.stereotype.Service; 
import org.springframework.transaction.annotation.Transactional; 
import xiao.ze.demo.entity.User; 
import xiao.ze.demo.mapper.UserMapper; 
import xiao.ze.demo.service.UserService; 
import javax.annotation.Resource; 
import java.util.List; 
QService 
QTransactional(rollbackFor = Exception.class) 
public class UserServiceImpl implements UserService { 
QResource 
private UserMapper userMapper ; 
QOverride 
public List«User» loadUserByUserName (String userName) { 
List«User» users - null; 
User user - userMapper.loadUserByUserName (userName); 
users -userMapper.select (user); 
return users; 
} 
QOverride 
public void addUser(User user) { 
userMapper.insert (user); 


接口 CourseTypeService 实现 类 CourseTypeServiceImpl 的 代码 如 例 10-10 所 示 。 
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【 例 10-10] 接口 CourseTypeService 实现 类 CourseTypeServiceImpl 的 代码 示例 。 


package xiao.ze.demo.service.impl; 
import org.springframework.stereotype.Service; 
import org.springframework.transaction.annotation.Transactional; 
import xiao.ze.demo.entity.CourseType; 5 
import xiao.ze.demo.mapper.CourseMapper; 
import xiao.ze.demo.mapper.CourseTypeMapper; 
import xiao.ze.demo.service.CourseTypeService; 
import javax.annotation.Resource; 
import java.util.List; 
QService 
QTransactional(rollbackFor = Exception.class) 
public class CourseTypeServiceImpl implements CourseTypeService { 
QResource 
private CourseTypeMapper courseTypeMapper; 
QGResource 
private CourseMapper courseMapper; 
QOverride 
public void addCourseType (CourseType courseType) ( 
courseTypeMapper.insert (courseType); 
} 
QOverride 
public void removeCourseType (Integer typeId) { 
if (CourseMapper.loadCourseByTypeId (typeId) !-null)q( 
courseMapper.removeCourseByTypeId (typeIg); 
} 
courseTypeMapper.deleteByPrimaryKey (typeId); 
} 
QOverride 
public void updateCourseType (CourseType courseType) ( 
courseTypeMapper.updateByPrimaryKey (courseType); 
) 
QOverride 
public CourseType getCourseTypeById(Integer typeId) { 
return courseTypeMapper.selectByPrimaryKey (typeId); 
} 
QOverride 
public List«CourseType» loadAll() ( 


return courseTypeMapper.selectAll(); 


接口 CourseService 实现 类 CourseServiceImpl 的 代码 如 例 10-11 所 示 。 
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【 例 10-11】 接口 CourseService 实现 类 CourseServiceImpl 的 代码 示例 。 


package xiao.ze.demo.service.impl; 
import org.springframework.stereotype.Service; 
import org.springframework.transaction.annotation.Transactional; 
import xiao.ze.demo.entity.Course; 
import xiao.ze.demo.mapper.CourseMapper; 
import xiao.ze.demo.service.CourseService; 
import xiao.ze.demo.utils.CourseQueryHelper; 
import javax.annotation.Resource; 
import java.util.HashMap; 
import java.util.List; 
import java.util.Map; 
QService 
QTransactional(rollbackFor = Exception.class) 
public class CourseServiceImpl implements CourseService { 
QGResource 
private CourseMapper courseMapper; 
QOverride 
public void addCourse (Course course) { 
courseMapper.addCourse (course); 
} 
QOverride 
public boolean removeCourseByNo(String courseNo) { 
courseMapper.removeCourseByNo (courseNo) ; 
return true; 
} 
QOverride 
public void updateCourse(Course course) { 
String[] courseReq = course.getCourseReqs(); 
if (courseReq !- null && courseReq.length > 0) { 
courseMapper.updateCourse (course); 
} else { 
course.setReqs(""); 
courseMapper.updateCourse (course); 


} 


QOverride 
public Course loadCourseByNo(String courseNo) { 
Course course-new Course(); 
course-null; 
if(courseNo!-null) ( 
course = courseMapper.loadCourseByNo (courseNo); 
} 


return course; 


} 


QOverride 
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public List«Course» loadScopedCourses (CourseQueryHelper helper) { 
Map«String,Object» map = new HashMap<> (16); 
map-getQueryHelper (helper); 
List«Course» list - courseMapper.loadScopedCourses (map); 
return list; à 
) 4 
QOverride 
public byte[] getTextbookPic(String courseNo) { 
byte[] textBookPic = null; 
Course course - courseMapper.loadCourseByNo (courseNo); 
textBookPic = course.getCourseTextbookPic (); 
return textBookPic; 
} 
private Map«String,Object» getQueryHelper (CourseQueryHelper helper) ( 
Map«String,Object» map = new HashMap<> (16); 
if (helper.getQryCourseName ()!-null)( 
map.put("qryCourseName", helper.getQryCourseName()); 
} 
if (helper.getQryEndPoint () !=null){ 
map.put("qryEndPoint", helper.getQryEndPoint ()); 
} 
if (helper.getQryStartPoint()!-null)( 
map.put("qryStartPoint", helper.getQryStartPoint()); 
} 
if((helper.getQryCourseType()!-null)&&(!"".equals (helper. 
getoryCourseType ())))í( 
map.put("typeld", Integer.parseInt (helper.getQryCourseType ())); 
) 
return map; 


10.2.5 创建 Mapper 接口 


接口 UserMapper 的 代码 如 例 10-12 所 示 。 
【 例 10-12] 接口 UserMapper 的 代码 示例 。 


package xiao.ze.demo.mapper; 

import tk.mybatis.mapper.common.Mapper; 

import xiao.ze.demo.entity.User; 

interface UserMapper extends Mapper«User» { 
User loadUserByUserName (String userName); 

) 


接口 CourseTypeMapper 的 代码 如 例 10-13 所 示 。 
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【 例 10-13】 接口 CourseTypeMapper 的 代码 示例 。 


package xiao.ze.demo.mapper; 


import tk.mybatis.mapper.common.Mapper; 


import xiao.ze.demo.entity.CourseType; 


public interface CourseTypeMapper extends Mapper«CourseType» ( 


} 


接口 CourseMapper 的 代码 如 例 10-14 所 示 。 
【 例 10-14] 接口 CourseMapper 的 代码 示例 。 


package xiao.ze.demo.mapper; 


import xiao.ze.demo.entity.Course; 


import java.util.List; 


import 


java.util.Map; 


public interface CourseMapper { 


void addCourse(Course course); 


boolean removeCourseByNo (String courseNo); 


boolean removeCourseByTypeId(Integer typeIdgd); 


void updateCourse (Course course); 


Course loadCourseByNo(String courseNo); 


List«String» loadCourseByTypeId(Integer typeId); 


List«Course» loadScopedCourses (Map map); 


10.2.6 


创建 类 WebLogAspect 


日 志 类 WebLogAspect 的 代码 如 例 10-15 所 示 。 
【 例 10-1S】 日 志 类 WebLogAspect 的 代码 示例 。 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


import 


org.aspectj.lang.annotation.Aspect; 
org.slf4j.Logger; 

org.slf4j.LoggerFactory; 
org.springframework.stereotype.Component; 
java.util.Arrays; 

java.util.Enumeration; 
javax.servlet.http.HttpServletRequest; 
org.aspectj.lang.JoinPoint; 
org.aspectj.lang.annotation.AfterReturning; 
org.aspectj.lang.annotation.Before; 
org.aspectj.lang.annotation.Pointcut; 
org.springframework.web.context.request.RequestContextHolder; 


org.springframework.web.context.request.ServletRequestAttributes; 


// 实 现 web 层 的 日 志 切 面 


QAspect 


QGComponent 
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public class WebLogAspect { 
private Logger logger = LoggerFactory.getLogger (this.getClass()); 
ThreadLocal«Long» startTime = new ThreadLocal«Long»(); 
QPointcut ("execution(* xiao.ze.demo.service.impl.*.*(..))") 
public void webLog()í) à 
QBefore ("webLog()") j 
public void doBefore(JoinPoint joinPoint)( 
startTime.set(System.currentTimeMillis()); 
/ /接收 到 请 求 ， 记 录 请 求 内 容 
logger.info("WebLogAspect.doBefore()"); 
ServletRequestAttributes attributes - (ServletRequestAttributes) 
RequestContextHolder.getRequestAttributes(); 
HttpServletRequest request - attributes.getRequest(); 


// 记 录 请 求 内 容 

logger.info("URL : " + request.getRequestURL().toString()); 
logger.info("HTTP METHOD : " + request.getMethod()); 
logger.info("IP : " + request.getRemoteAddr () ) ; 
logger.info("CLASS METHOD : " + joinPoint.getSignature(). 
getDeclaringTypeName() + "." + joinPoint.getSignature().getName()); 
logger.info("ARGS : " + Arrays.toString(joinPoint.getArgs())):; 
// 获 取 所 有 参数 方法 


Enumeration«String» enu-request.getParameterNames(); 
while(enu.hasMoreElements())( 
String paraName- (String)enu.nextElement (); 
System.out.println(paraName-": "«request.getParameter (paraName)); 


} 

QAfterReturning ("webLog()") 

public void doAfterReturning(JoinPoint joinPoint){ 
// 处 理 完 请求 ， 返 回 内 容 
logger.info("WebLogAspect.doAfterReturning()"); 
logger.info(" 耗 时 (毫秒) : " + (System.currentTimeMillis() - 
startTime.get())); 


10.2.7 创建 类 CourseQueryHelper 


辅助 分 页 类 CourseQueryHelper 的 代码 如 例 10-16 所 示 。 
【 例 10-16】 辅助 分 页 类 CourseQueryHelper 的 代码 示例 。 


package xiao.ze.demo.utils; 

public class CourseQueryHelper { 
private String qryCourseName; 
private Double qryStartPoint; 
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private Double qryEndPoint; 

private String qryCourseType; 

public String getQryCourseName() { 
return qryCourseName; 

} 

public void setQryCourseName (String qryCourseName) ( 
this.qryCourseName - qryCourseName; 

} 

public Double getQryStartPoint() ( 
return qryStartPoint; 

} 

public void setQryStartPoint(Double qryStartPoint) { 
this.qryStartPoint - qryStartPoint; 

} 

public Double getQryEndPoint() ( 
return qryEndPoint; 

} 

public void setQryEndPoint (Double qryEndPoint) ( 
this.qryEndPoint - qryEndPoint; 

} 

public String getQryCourseType() ( 
return qryCourseType; 

} 

public void setQryCourseType(String qryCourseType) ( 
this.qryCourseType - qryCourseType; 


10.2.8 ”创建 控制 各 类 


控制 器 类 IndexController 的 代码 如 例 10-17 所 示 。 
【 例 10-17】 控制 器 类 IndexController 的 代码 示例 。 


package xiao.ze.demo.controller; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.GetMapping; 
QController 
public class IndexController { 
QGetMapping ("/") 
public String root() Ti 


return "indes": 


} 


控制 器 类 SecurityController 的 代码 如 例 10-18 所 示 。 
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【 例 10-18】 控制 器 类 SecurityController 的 代码 示例 。 


package xiao.ze.demo.controller; 
import java.util.List; 
import java.util.Map; 
import org.springframework.beans.factory.annotation.Autowired; " 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.*; 
import xiao.ze.demo.entity.User; 
import xiao.ze.demo.service.UserService; 
import javax.servlet.http.HttpServletRequest; 
QGController 
QGRequestMapping ("/security") 
public class SecurityController { 
QAutowired 
private UserService userService ; 
QGRequestMapping ("/index") 
public String root() ( 
return "index"; 
) 
QGetMapping ("/toLogin") 
public String toLogin(Map«cString, Object» map) ( 
map.put("user", new User()): 
return "login"; 
} 
// 注 册页 面 
@RequestMapping ("/register") 
public String register (){ 
return "register"; 
} 
// 注 册 协 议 页 面 
@RequestMapping ("/readdoc") 
public String readdoc () { 
return "readdoc"; 
} 
// 注 册 方 法 
QRequestMapping ("/addregister") 
public String register(HttpServletRequest request)( 
String username - request.getParameter ("username"); 
String password - request.getParameter ("password"); 
String password2 = request.getParameter ("password2"); 
if (password.equals (password2))( 
User userEntity - new User(); 
userEntity.setUserName (username); 


userEntity.setUserPwd (password); 
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userService.addUser (userEntity); 
return "login"; 
Jelse { 


return "register"; 


t } 
QPostMapping (value="/login") 
public String login( User user,Map<String, Object» map ) { 
if (userService.loadUserByUserName (user.getUserName ())!-null)( 
List«User» lus-userService.loadUserByUserName (user. 
getUserName ()); 
if(lus.get(0).getUserPwd().equals(user.getUserPwd()))í( 
map.put ("user",lus.get (0)); 


FBIHPH "main = 


} 
return "login"; 
} 
QGGetMapping ("/mainController") 
public String main()( 
return "main"; 
) 
QGetMapping ("/logout") 
public String logout()( 
return "redirect:/security/toLogin"; 


控制 器 类 CourseTypeController 的 代码 如 例 10-19 所 示 。 
【 例 10-19】 控制 器 类 CourseTypeController 的 代码 示例 。 


package xiao.ze.demo.controller; 
import com.github.pagehelper.PageHelper; 
import com.github.pagehelper.PageInfo; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.*; 
import xiao.ze.demo.entity.CourseType; 
import xiao.ze.demo.service.CourseTypeService; 
import java.util.List; 
import java.util.Map; 
QGController 
QGRequestMapping ("/courseType") 
public class CourseTypeController { 

QAutowired 

private CourseTypeService courseTypeService ; 
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QGGetMapping ("/toInput") 
public String input(Map«String, Object» map) ( 
map.put("courseType", new CourseType()); 
return "courseType/input course type"; 
) $ 
@PostMapping (value="/create") 
public String create(CourseType courseType) { 
courseTypeService.addCourseType (courseType); 
return "redirect:/courseType/list"; 
) 
QGGetMapping ("/list") 
public String list(Map«String, Object» map, @RequestParam (value= 
"pageNo", required-false, defaultValue-"1") String pageNoStr) { 
int pageNo = 1; 
pageNo - Integer.parseInt (pageNoStr); 
if(pageNo < 1){ 
pageNo - 1; 
} 
PageHelper.startPage(pageNo, 10); 
List«CourseType» courseTypeList = courseTypeService.loadAl1l(); 
PageInfo«CourseType» page-new PageInfo«CourseType» (courseTypeList); 
map.put("page", page); 
return "courseType/list course type"; 
} 
QDeleteMapping (value-"/remove/(typeId)") 
public String remove(G8PathVariable("typeId") Integer typeId) { 
courseTypeService.removeCourseType (typeId); 
return "redirect:/courseType/list"; 
) 
QGetMapping (value-"/preUpdate/(typeId)") 
public String preUpdate (8PathVariable("typeld") Integer typeld, 
Map«String, Object» map) ( 
System.out.println(courseTypeService.getCourseTypeById (typeId)):; 
map.put("courseType", courseTypeService.getCourseTypeByld (typeId)); 
return "courseType/update course type"; 
} 
QPutMapping (value-"/update") 
public String update(CourseType courseType) { 
courseTypeService.updateCourseType (courseType); 


return "redirect:/courseType/list"; 


控制 器 类 CourseController 的 代码 如 例 10-20 所 示 。 
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【 例 10-20】 控制 器 类 CourseController 的 代码 示例 。 


package xiao.ze.demo.controller; 
import com.github.pagehelper.PageHelper; 
import com.github.pagehelper.PageInfo; 
^ import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.*; 
import org.springframework.web.multipart.MultipartFile; 
import xiao.ze.demo.entity.Course; 
import xiao.ze.demo.service.CourseService; 
import xiao.ze.demo.service.CourseTypeService; 
import xiao.ze.demo.utils.CourseQueryHelper; 
import javax.servlet.ServletOutputsStream; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
import java.io.File; 
import java.io.FileInputStream; 
import java.util.List; 
import java.util.Map; 
QGController 
QGRequestMapping ("/course") 
public class CourseController { 
QAutowired 
private CourseService courseService; 
QGAutowired 
private CourseTypeService courseTypeService ; 
QModelAttribute 
public void getCourse(RequestParam(value-"courseNo",required-false) 
String courseNo, Map«String, Object» map,Course course)( 
course-courseService.loadCourseByNo (courseNo); 
if(courseNo !- null&&course!- null)( 


map.put("course", course); 


) 

QGGetMapping ("/toInput") 

public String toInput(Map«String, Object» map,Course course) { 
map.put("courseTypeList", courseTypeService.loadAll()); 
course.setCourseStatus ("O"); 
course.setCourseReqs (new String[]í"a","b"]); 
map.put("course", course); 
return "course/input course"; 

} 

QPostMapping (value-"/create") 

public String create(8RequestParam("coursetextbookpic") MultipartFile 

file, Course course, Map«String, Object» map) throws Exception( 
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// 读 取 文 件数 据 ， 转 成 字 节 数组 

if (file!-null)(|( 
course.setCourseTextbookPic(file.getBytes()); 

} 

try{ $ 
courseService.addCourse (course); 
System.out .println ("你 好 "); 

}catch (Exception e)( 
map.put("exceptionMessage", e.getMessage()); 
map.put("courseTypeList", courseTypeService.loadAll()); 
return "course/input course"; 


} 


return "redirect:/course/list"; 
) 
QRequestMapping ("/list") 
public String list(RequestParam(value-"pageNo", required-false, 
defaultValue-"]") String pageNosStr, 
Map«String, Object» map, CourseQueryHelper helper) { 
int pageNo = 1; 
// 对 pageNo 的 校 验 
pageNo - Integer.parseInt (pageNoStr); 
if(pageNo < 1)( 
pageNo - 1; 
} 
PageHelper.startPage (pageNo, 4); 
List<Course> courselist = courseService.loadScopedCourses (helper); 
PageInfo«Course» page-new PageInfo«Course»(courselist); 
map.put("courseTypeList", courseTypeService.loadAll()); 
map.put("page", page); 
map.put("helper", helper); 
return "course/list course"; 
) 
QDeleteMapping (value-"/remove/(courseNo]") 
public String remove (G8PathVariable("courseNo") String courseNo) { 
courseService.removeCourseByNo (courseNo); 
return "redirect:/course/list"; 
} 
QGetMapping (value="/preUpdate/ {courseNo}") 
public String preUpdate (@PathVariable("courseNo") String courseNo, 
Map«String, Object» map) { 
map.put("course" ,courseService.loadCourseByNo (courseNo)); 
map.put("courseTypeList", courseTypeService.loadAll()); 
return "course/update course"; 


} 
&GPostMapping (value-"/update") 
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public String update (8RequestParam("coursetextbookpic") MultipartFile 
file, Course course, Map«String, Object» map) throws Exception( 
// 读 取 多 段 提交 的 文件 数据 ， 转 成 字 节 数组 
if(file.getBytes () .Jengqth>0) { 
course.setCourseTextbookPic(file.getBytes()); 
) 
try( 
courseService.updateCourse (course); 
)catch (Exception e)( 
map.put("exceptionMessage", e.getMessage()); 
map.put("courseTypeList", courseTypeService.loadAll()); 
return "/course/update course"; 


} 


return "redirect:/course/list"; 
} 
QGetMapping ("/getPic/(courseNo]") 
public String getPic(8PathVariable("courseNo") String courseNo, 
HttpServletRequest request, HttpServletResponse response) throws 
Exception( 
byte[] textBookPic = courseService.getTextbookPic (courseNo); 
if (textBookPic--null)( 
String path = request.getSession().getServletContext () . 
getRealPath("/pics/default.jpg"); 
FileInputStream fis = new FileInputStream(new File (path)); 
textBookPic = new byte[fis.available()]; 
fis.read(textBookPic); 


) 

// 回 浏览 器 发 通知 ， 我 要 发 送 的 是 图 片 
response.setContentType ("image/jpeg"); 
ServletOutputStream sos-response.getOutputStream(); 
sos.write(textBookPic); 

sos.flush(); 

sos.close(); 

return null; 


10.2.9 ”修改 和 人口 类 


修改 后 的 入 口 类 代码 如 例 10-21 所 示 。 
【 例 10-21】 修改 后 的 入 口 类 的 代 人 码 示 例 。 
package xiao.ze.demo.start; 


import tk.mybatis.spring.annotation.MapperScan; 
import org.springframework.boot.SpringApplication; 
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import org.springframework.boot.autoconfigure.SpringBootApplication; 
import org.springframework.context.annotation.ComponentScan; 


import org.springframework.transaction.annotation.EnableTransactionManagement; 


QGComponentScan(basePackages = "xiao.ze.demo") 
QGSpringBootApplication à 
QGMapperScan(basePackages -"xiao.ze.demo.mapper") t 


@EnableTransactionManagement 
public class App { 
public static void main(String[] args) { 


SpringApplication.run(App.class, args); 


10.2.10 ”创建 XML 文件 


文件 CourseMapper.xml 的 代码 如 例 10-22 所 示 。 
【 例 10-22] 文件 CourseMapperxml 的 代码 示例 。 


<?xml version-"1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper 
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"» 
<!-- 配 置 命名 空间 ， 区 别名 称 --> 
«mapper namespace-"xiao.ze.demo.mapper.CourseMapper"» 
«1--SQL 片段 --> 
«sql id-"cols"»course no, 
course name, 
course hours, 
type id, 
course status, 
COHLFSG FOgs, 
course point, 
course memo, 
course textbook pic 
</sql> 
<!-- 中 间 ， 对 象 的 属性 和 结果 集 的 字段 之 间 的 对 应 关系 --> 
«resultMap type-"xiao.ze.demo.entity.Course" id-"courseRM"» 
<!-- 主 键 映 射 --> 
«id property-"courseNo" column-"course no"/» 
<!-- 普 通 字段 property 指 实体 的 属性 ;column 结果 集 的 字段 名 称 --> 
«result property-"courseName" column-"course name"/» 
«result property-"courseHours" column-"course hours"/» 
«result property-"courseStatus" column-"course status"/» 
«result property-"reqs" column-"course reqs"/» 
«result property-"coursePoint" column-"course point"/» 
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«result property-"courseMemo" column-"course memo"/> 
«result property-"courseTextbookPic" column-"course textbook pic"/» 
<!-- 对 象 关 联 --> 
«association property-"courseType" javaType-"xiao.ze.demo.entity. 
CourseType"» 

<!-- 主 键 映 射 --> 

«id property-"typeld" column-"type id"/» 

<!-- 普 通 字段 property 指 实体 的 属性 ，column 结果 集 的 字段 名 称 --> 


«result property-"typeName" column-"type name"/» 


«/association» 
«/resultMap» 
«1--3ap$g--» 


«insert id-"addCourse" parameterType-"xiao.ze.demo.entity.Course"» 
insert into tbl course 
(«include refid-"cols"/») 
values 
(S(courseNo),f4(courseNamej),£4(courseHours], 
#{courseType.typeId}, #{courseStatus},#{reqs}, 
#{coursePoint}, #{courseMemo}, #{courseTextbookPic, jdbcType-BLOB]) 
</insert> 
<delete id="removeCourseByNo" parameterType="string"> 
delete from tbl course 
where course no = dttcourseNo] 
«/delete» 
«delete id-"removeCourseByTypeId" parameterType-"int"» 
delete from tbl course 
where type id = #{typeId} 
«/delete» 
<! 一 -修改 --> 
«update id-"updateCourse" parameterType-"xiao.ze.demo.entity.Course" > 
update tbl course 
«set» 
«if test-"courseName!-null"»course name-4(courseName],-«/if» 
«if test-"courseHours!-null"»course hours-£4$(courseHours],«/if» 
«if test-"courseType!-null"»type id-4(courseType.typeId),«/if» 
«if test-"courseStatus!-null"»course status-4(courseStatus],«/if» 
«if test-"reqs!-null"»course reqs-£4(reqs),«/if» 
«if test-"coursePoint!-null"»course point-£(coursePointj],«/if» 
«if test-"courseMemo!-null"»course memo-4í(courseMemo],«/if» 
«if test-"courseTextbookPic!-null"»course textbook pic=# 
(courseTextbookPic, jdbcType-BLOB],«/if» 
«/set» 
where course no = #{courseNo} 
«/update» 
«select id-"loadCourseByNo" parameterType-"string" resultType-"xiao. 
ze.demo.entity.Course" resultMap-"courseRM"» 
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select 
p-.course no,p.course name,p.course hours,p.course status, 
p.course reqs,p.course point,p.course memo,p.course textbook pic, 
b.type id,b.type name 
from tbl course p $ 
left join tbl course type b 
on p.type id=b.type id 
where p.course no- #{courseNo} 
«/select» 
<!-- 根 据 typera 查询 --> 
«select id-"loadCourseByTypeId" parameterType-"int" resultType-"string"» 
select course no from tbl course 
where type id= £(typeId) 
</select> 
<! 一 - 带 分 页 郁 询 ， 注 意 MyBatis 中 如 果 填 写 集合 类 型 ， 则 只 填写 集合 中 元 素 的 类 型 --> 
«select id-"loadScopedCourses" parameterType-"map" resultType-"xiao.ze. 
demo.entity.Course" resultMap-"courseRM"» 
select * from tbl course p 
left join tbl course type b 
on p.type id-b.type id 
«where» 
1-1 
«if test-"qryCourseName!-null"»and p.course name like concat (concat 
('$', 4(qryCourseName]), '$')«/if» 
«if test-"qryStartPoint!-null"»and p.course point >= 
f(qryStartPoint)«/if» 
«if test-"qryEndPoint!-null"»and p.course point «![CDATA[ <= ]]» 
f(qryEndPointj«/if» 
<if test-"typelId!-null"»5and p.type id = #{typeId}</if> 
«/where» 
order by p.course no 
«/select» 
«/mapper» 


文件 UserMapper.xml 的 代码 如 例 10-23 所 示 。 
【 例 10-23】 文件 UserMapperxml 的 代码 示例 。 


<?xml version-"1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper 
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"» 
<!-- 配 置 命名 空间 ， 区 别名 称 --> 
«mapper namespace-"xiao.ze.demo.mapper.UserMapper"» 
<!-- SQL 片段 --> 
«sql id-"cols"»user no, 
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user name, 


user pwd 
«/sq1l» 
«resultMap type-"xiao.ze.demo.entity.User" id-"userRM"» 
à <!-- 主 键 映 射 --> 
«id property-"userNo" column-"user no"/» 


<!-- 普 通 字段 property 指 实体 的 属性 ，column 结果 集 的 字段 名 称 --> 
«result property-"userName" column-"user name"/» 
«result property-"userPwd" column-"user pwd"/» 
«/resultMap» 
<!-- 新 增 --> 
«insert id-"addUser" parameterType-"xiao.ze.demo.entity.User" > 
insert into tbl users 
(«include refid-"cols"/») 
values 
(#{userNo},#{userPwd},#{userName}) 
«/insert» 
<!-- 根 据 用 户 名 奋 询 --> 
«select id-"loadUserByUserName" parameterType-"string" resultType- 
"Xiao.ze.demo.entity.User" resultMap-"userRM"» 
select * from tbi users 
where user name = #{userName} 
«/select» 
«/mapper» 


10.2.11 创建 HTML 文件 


在 目录 resources/templates 下 创建 文件 footer.html， 代 人 码 如 例 10-24 所 示 。 
【 例 10-24】 创建 文件 footerhtml 的 代码 示例 。 


<!DOCTYPE html SYSTEM "http://www.thymeleaf.org/dtd/xhtmll-strict- 
thymeleaf-4.dtd"» 
«html xml1ns-"http://www.w3.org/1999/xhtml" xmlns:th-"http://www.thymeleaf. 
Seq” > 
<body> 
<div th:fragment="copy"> 
&copy; 2018 参考 网 上 实例 
</div> 
<div th:fragment="time"> 
«a id-"time"»«/a» 
«script th:inline-"javascript"» 
function setTime()( 
var dt-new Date(); 
var arr week-new Array ("星期 日 ", "星期 一 ", "星期 二 ", "星期 三 ", "星期 四 ", "星期 
h","ENIA"); 


第 10 章 Spring Boot 开发 案例 


Var strWeek-arr week[dt.getDay()]; 


var strHour-dt.getHours (); 
var strMinutes-dt.getMinutes (); 
var strSeconds-dt.getSeconds(); 


1f (strMinutes«10) strMinutes-"0"4strMinutes; 


1f (strSeconds«10) strSeconds-"0"4strSeconds; 
var strYear-dt.getFullYear()-4"fF"; 
var strMonth- (dt.getMonth()-«1)«"H"; 


var strDay-dt.getDate()-«"H"; 


«!--var strTime-strHour-":"astrMinutes-":"4strSeconds;--» 


strTime-strHour-*":"4strMinutes; 


time . innerHTML=" 当 前 时 间 为 "+strYear+strMonth+strDay+ 


" "¿strTime+" "+strWeek; 
} 
setInterval ("setTime()",1000); 
«/script» 
<div> 
</body> 
«/html» 


在 日 录 resources/templates 下 创建 文件 index.html, 
【 例 10-25] 创建 文件 index.html 的 代码 示例 。 


«!DOCTYPE html» 
«html lang-"en"» 
«head» 

«meta charset-"UTF-8"» 

«title»index«/title» 

«script type-"text/javascript"» 
var loginPage - "security/toLogin"; 
location.href-loginPage; 

«/scripb» 

</head> 
<body> 

</body> 
</html> 


代码 如 例 10-25 所 示 。 


在 目录 resources/templates 下 创建 文件 login.html， 代 人 码 如 例 10-26 所 示 。 


【 例 10-26】 创建 文件 login.html 的 代码 示例 。 


«'!DOCTYPE html» 


«html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 


«head» 
«meta charset-"UTF-8"» 
< 上 tit1le> 课 程 管理 系统 登录 页 面 </tit1Le> 


«link rel="stylesheet" type="text/css" th:href-"Q(/css/style.css)" /> 


«script type-"text/javascript" th:src-"Q(/js/jquery-3.1.1.min.js)"» 
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«/script» 
</head> 
<body> 
<div> 
$ <div id="wrapper" style="text-align:center"> 
i «img id-"login"  width-"100" height-"20"  th:src-"Q(/pics/ 


logo.png)" /»«div id-"f tit1le"> 课 程 管理 系统 用 户 登 录 </div><br> 
«form th:action="@{/security/login}" method="post" th:object- 
"S(user)"» 
«div class-"f row"» 
«span» HP HE% :«/span» 
«input type-"text" class-"form-control" name-"userName" 
placeholder=" 请 输入 姓名 "> 
«/div» 
«div class-"f row"» 
«span» SK 43 : </span> 
«input type-"text" class-"form-control" name-"userPwd" 
placeholder=" 请 输入 密码 "> 
</div> 
<br> 
<div class="f row"> 
«input type-"submit" value-" f x* "»«/input» 
«a th:href-"8(/security/register)" class-"zcxy" target- 
" blank"> 注 册 </a> 
«/div» 
«/form» 
«/div» 
«/div» 
«div id-"footer"» 
«div th: include-"footer :: copy"»«/div»«div th:include-"footer :: time"» 
«/div» 
«/div» 
«/body» 
«/html» 


在 目录 resources/templates 下 创建 文件 maimn.html， 代 码 如 例 10-27 所 示 。 
【 例 10-27】 创建 文件 main.html 的 代码 示例 。 


«!DOCTYPE html» 
«html lang-"en" xmlns-"http://www.w3.org/1999/xhtml1" xmlns:th-"http://www. 
thymeleaf.org"» 
«head» 

«meta charset-"UTF-8"» 

<title> 课 程 管 理 系统 </title> 

«link rel-"stylesheet" type-"text/css" th:href="@{/css/style.css}" /> 
</head> 
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«body» 
sb dl le, 


<div id="productName"> 


课程 管理 系统 
«img id-"headpic"  width-"30" height-"30" th:src="@{/pics/sbl. $ 
pngj" /» à 
«/div» 


«div style-"float:right; margin:30px;"» 
操作 员 : [[$(user.userName]]]&nbsp; 
«a th:href-"Q((/security/logout)" Cicle "MHATA" id-"logout"» 
«img id-"lopics"  width-"30" height-"30"  th:src-"Q(/pics/ 
logout.jpg)" /» 
«span style-"cursor: pointer" class-"linkspan"»iHili«/span» 
</a> 
</div> 
</div> 
<div> 
<div id="navigator"> 
<div class="menuitem"> 
«a th:href-"((/courseType/toInput)" Carget "contenti rame >se 
课程 类 型 </a> 
«/div» 
«div class-"menuitem"» 
«a th:href-"8(/courseType/list)" target-"contentFrame "> 课程 类 型 
管理 </a> 
«/div» 
«div class-"seperator"»«/div» 
«div class-"menuitem"» 
«a th:href-"( (/course/toInput]" target-"contentFrame"»JfW Uu iu«/ a» 
«/div» 
«div class-"menuitem"» 
«a th:href-"8(/course/list)" target-"contentFrame "> 课程 管理 </a> 
«/div» 
«/div» 
«div id-"content"» 
«iframe id-"contentFrame" width-"100$" scrolling-"no" height- 
"480px" frameborder-"0O" name-"contentFrame" allowtransparency- 
"true" th:src-"8(/welcome.htmlj"» 
«/iframe» 
«/div» 
«/div» 
«div id-"footer"» 
«div th: include-"footer :: copy"»«/div»«div th: include-"footer :: time"» 
«/div» 
«/div» 
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«script type-"text/javascript" th:src-"Q(/js/jquery-3.1.1.min.js)"» 
«/script» 
«script th:inline-"javascript"» 
$("F£logout").click(function () ( 
à if(confirm('" 您 真 的 要 离开 系统 吗 ? '))( 
t SIPHcatinm alir hrei" thss-hreor(1)- 
) 
return false; 
H): 
«/script» 
</body> 
</html> 


在 目录 resources/templates 下 创建 文件 register.html, RE 10-28 所 示 。 
【 例 10-28】 创建 文件 registerhtml 的 代码 示例 。 
<!DOCTYPE html» 


«html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 
«!--html lang-"en"--» 


«head» 
«meta charset-"UTF-8" /» 
«title»Title«/title» 
</head> 
<body> 


<div class="web login"> 
<form name="form2" id="regUser" accept-charset="utf-8" action= 
"/security/addregister" method="post"> 
<ul class="reg form" id="reg-ul"> 
«div id-"userCue" class="cue"> 用 户 注 册 ， 请 注意 格式 </div> 
«label for-"username" class="input-tips2"> 用 户 名 : «/label» 
«div class-"inputOuter2"» 
«input type-"text" id-"username" name-"username" maxlength-"16" class- 
"inputstyle2"/» 
«/div» 
«label for-"password" class-"input-tips2"»4-lJj: «/label» 
«div class-"inputOuter2"» 
«input type-"password" id-"password"  name-"password" maxlength-"16" 
class-"inputstyle2"/» 
«/div» 
«label for-"password2" class="input-tips2"> 确 认 密 码 : «/label» 
«div class-"inputOuter2"» 
«input type-"password" id-"password2" name-"password2" maxlength-"16" 
class-"inputstyle2" /> 
«/div» 
«div class-"inputArea"» 
«a th:href-"Q(/security/readdoc])" class-"zcxy" target-" blank"» 
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阅读 注册 协议 </a> 
«input type="submit" id-"reg" style="margin-top:10px; 
margin-left:10px;" class-"button blue" value=" 同 意 协议 并 注册 "/> 
«/div» 
«div class-"cl"»«/div» $ 
«Fui» 
«/form» 
«/div» 
«/body» 
«/html» 


在 目录 resources/templates 下 创建 文件 readdoc.html， 代 码 如 例 10-29 所 示 。 
【 例 10-29] 创建 文件 readdoc.html 的 代码 示例 。 


<!DOCTYPE html SYSTEM "http://www.thymeleaf.org/dtd/xhtmll-strict- 
thymeleaf-4.dtd"» 
<html xmlns-"http://www.w3.org/1999/xhtml" xmlns:th-"http://www. 
thymeleaf.org"» 
«body» 
«div» 
«span» 
注意 事项 : 
必须 注册 后 才能 登录 。 
«/span»«a th:href-"G8(/security/register)" > 返回 注册 页 面 </a> 
«/div» 
«/body» 
«/html» 


在 resources/templates/courceType 下 创建 文件 input course type.html, fV infi] 10-30 
所 示 。 
【 例 10-30】 创建 文件 input course type.html 的 代码 示例 。 


«!DOCTYPE html» 
«html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 
«head» 
«meta charset-"UTF-8"» 
<title> 新 增 课程 类 型 </title> 
«link rel="stylesheet" type="text/css" th:href="@{/css/style.css}" /> 
«script type-"text/javascript" th:src-"Q(/js/jquery-3.1.1.min.js)"» 
«/script» 
</head> 
<body style="padding: 8px; "> 
<h3 class="title"> 新 增 课程 类 型 </h3> 
«form th:action="@{/courseType/create}" method-"post" th:object- 
"$S(courseType)"» 
«div» 
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<span> 课 程 类 型 名 称 :</span> 
«input type="text" name-"typeName" placeholder=" 课 程 类 型 名 称 "> 
</div> 
«div» 
à «input Lype "submit" value-" ME "/» 
M «/div» 
«/form» 
«/body» 
«/html» 


在 目录 resources/templates/courceType 下 创建 文件 list course type.html, 代码 如 例 10-31 
所 示 。 
【 例 10-31】 创建 文件 list_course_type.html 的 代码 示例 。 


<!DOCTYPE html» 
<html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 
«head» 
«meta charset-"UTF-8"» 
<title> 课 程 类 型 管理 </title> 
<link rel="stylesheet" type="text/css" th:href="@{/css/style.css}" /> 
</head> 
«body style-"padding:8px;"» 
«h3 class="title"> 课 程 类 型 管理 </h3> 
«form action-"" method-"POST"» 
«input type-"hidden" name-" method" value-"DELETE"/» 
«/form» 
«table border-"0" cellspacing-"0"» 
cir 
<th> 编 号 </th> 
<th> 名 称 </th> 
<th> 操 作 </th> 
二 ge 
«tr class-"type" th:each-"courseType : $(page.list)"» 
«td th:text-"$(courseType.typeld)" nowrap»«/td» 
«td id-"typeName" th:text-"$(courseType.typeName)" nowrap»«/td» 
«td nowrap» 
«button class-"update" th:href-"Q8 (/courseType/preUpdate/(typelId) (typeId- 
S(courseType.typelId]))" > 修改 </button> 
«button class-"delete" th:href="@{/courseType/remove/{typelId} (typelId=$ 
(courseType.typeId])] "> 删除 </button> 
«/td» 
</tr> 
</table> 
<div id="pageInfo"> 
JŁ[[${page.total}]]%, 
«span th:if-"$( ( page.pageNum - 1 ) * page.pageSize + 1 == page.total }"> 
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当前 显示 第 [[${page.total}]] 条 ， 
</span> 
«span th:if-"$( ( page.pageNum - 1 ) * page.pageSize + 1 != page.total }"> 
当前 显示 [[${page.startRow}]]-[[${page.endRow}]] 条 ， 
</span> 
第 [[${page.pageNum}]]/[[${page.pages}]] 页 
| 
«a href="#" th:if="$ {page.pageNum>1}"><span class-"linkspan" id-"one"» 
首页 </span>&nbsp;</a> 
«a href="#" th:if="$ {page.pageNum>1}"><span class-"linkspan" id-"two"» 
上 一 页 </span>gnbsp;</a> 
«a href="#" th:if="${page.pageNum<page.pages}"><span class-"linkspan" 
id="three">3 下 一 矶 </span>tnbsp;</a> 
«a href="#" th:if="$ {page.pageNum!=page.pages}"><span class-"linkspan" 
id-"four"» A Jl«/span»&nbsp;«/a» 
| 
$| «input  type-"text"  id-"pageNo"  size-4  style-"text-align:right;" 
onkeypress-"onlynumber();"/» 页 
«button class-"linkspan" id-"five" style-"color:black;text- 
decoration:none;"» Pk 转 «/button» 
«/div» 
«script type-"text/javascript" th:src-"Q(/js/jquery-3.1.1.min.js)"» 
S/SCEPDES 
«script th:inline-"javascript"» 
SttuncEion() I 
/ /删除 操作 
Sn deleten Click ronet tion i 
yar hrec — StCLhis]-actrri"hbrer")- 
if (confirm(" 确 定 要 删除 吗 ?") ) { 
$("form:eq(0)").attr("action", href).submit(); 


return false; 


2E 
$(".update").click(function () A 
var href — S(this).attrí("href"); 
$(location).attr("href", href); 
)); 
// 分 页 操作 
$(".linkspan").click(function () ( 
var pageNo = [[S$í(page.pageNum]]]; 
var totalPageNum = [[S$(page.pages)]]; 
var re = /^[0-9]-4.2?[0-9]*$/; 
if (String($(this).attr("id")) -- String("one")) 
pageNo - 1; 
if (String($(this).attr("id")) -- String("two")) 
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pageNo = pageNo - 1; 


if (String($(this).attr("id")) -- String("three")) 
pageNo = pageNo + 1; 

if (String($(this).attr("id")) -- String("four")) 
pageNo = totalPageNum; 

if (String($(this).attr("id")) -- String("five")) 1 


var num = $.trim($("4£pageNo").val()); 
if ('!re.test(num)) | 
alert ("输入 的 不 是 数字 !")， 
return; 
} 
pageNo = parseInt (num); 


if (pageNo < 1 || pageNo > totalPageNum) { 
alert ("页 号 超出 范围 ， 有 效 范 围 ) [1-" + totalPageNum + "]!"); 
return; 
} 
} 
Var href = "?pageNo-" + pageNo; 


$(location).attr("href", bref); 
return false; 
)); 
jr 
«/script» 
«/body» 
«/html» 


在 目录 resources/templates/courceType 下 创建 文件 update course type.html, [V4 Zl 
4| 10-32 所 示 。 
【 例 10-32] 创建 文件 update course type.html 的 代 人 码 示例 。 


«!DOCTYPE html» 
«html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 
«head» 
«meta charset-"UTF-8"» 
<title> 修 改 课程 类 型 </title> 
«link rel-"stylesheet" type-"text/css" th:href="@{/css/style.css}" /> 
«script type-"text/javascript" th:src-"(/js/jquery-3.1.1.min.js)"» 
«/script» 
«/head» 
«body style-"padding:8px;"» 
<h3 class="tit1le"> 修 改 课 程 类 型 </h3> 
«form th:action-"Q(/courseType/update)" method="post" th:object- 
"S(courseType)"» 
«input type-"hidden" name-" method" value-"PUT"/» 
«input type="hidden" name-"typeId" th:value-"*(typeId)"» 
«div» 
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<span> 课 程 类 型 名 称 :</span> 
<input type="text" name="typeName" th:value="*{typeName}" placeholder= 
"课程 类 型 名 称 "> 
«/div» 
«div» à 
«input type-"submit" value-" ME "/» t 
</div> 
</form> 
</body> 
</html> 


在 目录 resources/templates/cource 下 创建 文件 input course.html， 代 人 码 如 例 10-33 所 示 。 
【 例 10-33] 创建 文件 input course.html 的 代码 示例 。 


«!DOCTYPE html» 
«html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 
«head» 
«meta charset-"UTF-8"» 
<title> 新 增 课程 类 型 </title> 
«link rel-"stylesheet" type-"text/css" th:href="@{/css/style.css}" /> 
</head> 
<body style="padding: 8px; "> 
<h3 class="title"> 新 增 课程 </h3> 
«img id-"textbookPic" 
alt=" 默 认 教材 封面 " 
width-"300" 
height-"250" 
style-"float:right" th:src-"Q8(/pics/SpringBoot.png)" /»«br/» 
«form th:action-"8(/course/createj" method="post" enctype-"multipart/ 
form-data" th:object-"$[(course]"» 
«div» 
<span>3 课 程 编 号 :</span> 
«input type-"text" name-"courseNo" > 
«/div» 
«div» 
«span» Wf AW :«/span» 
«input type-"text" name-"courseName" » 
«/div» 
«div» 
«span» 30M Ill : </span> 
«input id-"coursetextbookpic" type-"file" name-"coursetextbookpic" 
size-"40" /> 
«/div» 
«div» 
«span» ik fEUKRH] : «/span» 
«input type-"text" name-"courseHours" » 
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</div> 
<div> 
<span> 课 程 学 分 :</span> 
«input type-"text" name-"coursePoint" > 
E «/div» 
t <div> 
<span> 课 程 类 型 :</spany> 
«select name-"courseType.typeId"» 
<option>= 请 选择 =</option> 
«option th:each-"list:$(courseTypeList)" th:value= 
"$(list.typeId)" th:text-"$(list.typeName)"»«/option» 
«/select» 
«/div» 
«div» 
<span>3 课 程 状态 :</span> 
«input type-"radio" name-"courseStatus" th:value-"O" checked» JF JA 4 X 
&nbsp; &nbsp; 
«input type-"radio" name-"courseStatus" th:value-"Z"»TIAJPK 
&nbsp; &nbsp; 
«input type-"radio" name-"courseStatus" th:value-"C"»ffIEfZVR 
&nbsp; &nbsp; 
«/div» 
«div» 
<span> 选 课 条 件 :</span> 
«input type-"checkbox" name-"courseReqs" value-"a" /Ss 大 三 以 上 
«input type-"checkbox" name-"courseReqs" value="b" /> 平均 成 绩 80 分 
«input type-"checkbox" name-"courseReqs" value-"c" /> 非 本 专业 学 生 
«input type="checkbox" name-"courseReqs" value-"d" /»Jkjh/K^ H 
«/div» 
«div» 
«span» 4 itl : «/span» 
«textarea name-"courseMemo" rows-"6" cols-"60" »«/textarea» 
«/div» 
«div» 
«input type-"submit" value "HR /> 
</div> 
</form> 
</body> 
«script type-"text/javascript" th:src="Q@{/js/jquery-3.1.1.min.Jjs}"> 
«/script» 
«script th:inline-"javascript"» 
S(function() ( 
$("£coursetextbookpic").change(function (e) { 
for (var i = 0; i < e.target.files.length; i++) { 


var file = e.target.files.item(i); 
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var freader - new FileReader(); 

freader.readAsDataURL(filo); 

Ftreader.-onfboad — tuncEron de) d 
var src - e.target.result; 


SI"FfEGSxbbookPic")-attri"src", src) $ 


His 
«/SscriplE» 
«/html» 


在 目录 resources/templates/cource 下 创建 文件 list _ course.htm1， 代 人 码 如 例 10-34 所 示 。 
【 例 10-34】 创建 文件 list course.html [fV 37r hl. 


«!DOCTYPE html» 
<html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 
«head» 
«meta charset-"UTF-8"» 
<tit1le> 谍 程 类 型 管理 </tit1le> 
«link rel="stylesheet" type="text/css" th:href="@{/css/style.css}" /> 
</head> 
<body style="padding: 8px; "> 
<h3 class="title"> 课 程 管理 </h3> 


«form action-"" method-"POST"» 
«input type-"hidden" name-" method" value-"DELETE"/» 
«/form» 


«div id-"queryArea"» 

«form th:action-"8(/course/listj" method="post" th:object-"$(helperj"» 
课程 名 称 : «input type="text" name-"qryCourseName" /»&nbsp; &nbsp; 
ToM: «input type-"text" name-"qryStartPoint" size-"6" /» - «input 
type="text" name-"qryEndPoint" size-"6" /»&nbsp;&nbsp; 

FERAI: 

«select name-"qryCourseType"» 
«option value="">= 请 选择 =</option> 
«option th:each-"list:$(courseTypeList)" th:value="$ {11ist. 
typeld)" th:text="${list.typeName}"></option> 


</select> 
«input type-"submit" value-"frif]"/» 
«/form» 
«/div» 
«table border-"0" cellspacing-"0"» 
“EE 
<th> 序 号 </th> 
<th> 编 写 </th> 


<th> 名 称 </th> 
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<th> 课 时 </th> 
<th> 学 分 </th> 
<th> 类 型 </th> 
<th> 状 态 </th> 
$ <th> 选 读 要 求 </th> 
t <th> 备 注 </th> 
<th> 操 作 </th> 
/Lr 
«tr th:each-"course,iterStat : $[page.list)" stat» 
«td th:text-"$[(iterStat.index-1)" nowrap»«/td» 
«td th:text-"$(course.courseNo]" nowrap»«/td» 
«td nowrap style-"padding-top:10px;"» 
[[S(course.courseName]]]«br» 
«img width-"100" height-"50" th:alt="$ {course .courseName+' WÁ% 
H'y" th:src-"Q(/course/getPic/(courseNo) (courseNo- 
S(course.courseNo]))"/» 
Ao 
<td th:text="${course.courseHours}" nowrap></td> 
«td th:text="${course.coursePoint}" nowrap></td> 
«td th:text="${course.courseType.typeName}" nowrap></td> 
«td nowrap» 
«span th:if-"$(course.courseStatus eq 'O')"»5J[ A Xk«/span» 
«span th:if-"$(course.courseStatus eq 'Z')"»PI4JTFW«/span» 
«span th:if-"$(course.courseStatus eq 'C’"}"S> 停 止 授 课 </span> 
«/td» 
«td nowrap> 
«span th:each-"req : $(course.courseReqs)]"» 
chon th iF "red pd" 3 IK EEPDECKEDOHE: 
«font th:if-"$[(req eq 'b' }” > 平均 成 绩 80 分 </font> 
«font th:if-"$(req eq 'c'}"> 非 本 专业 学 生 </font> 
«font th:if-"S$(req eq 'd')"»lhXF*9c/tont» 
«/span» 
«/td» 
«td th:text-"$(course.courseMemo]" nowrap»«/td» 
«td» 
«button class-"update" th:href-"( (/course/preUpdate/(courseNo] 
(courseNo-$(course.courseNo]))"»1EiWM«/button» 
«button class-"delete" th:href-"(0(/course/remove/(courseNo] 
(courseNo=$ {course.courseNo})}"> 删 除 </button> 
Ed 
aCe 
</table> 
«div id-"pageInfo"» 
AX [[$tpage.total)]]^, 
«span th:if-"$( ( page.pageNum - 1 ) * page.pageSize + 1 == page.total )"» 
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当前 显示 第 [[${page.total}]] 条 ， 
</span> 
«span th:if-"$( ( page.pageNum - 1 ) * page.pageSize + 1 !- page.total }"> 
当前 显示 [[${page.startRow}]]-[[${page.endRow}]] 条 ， 
</span> à 
B [[$tpage.pageNum) ]1]/[[$tpage.pages)] ] t ' 
| 
«a href="#" th:if-"$(page.pageNum» 1) "»«span class-"linkspan" id-"one"» 
首页 </span>&nbsp;</a> 
«a href="#" th:if="$ {page.pageNum > 1}"><span class-"linkspan" id-"two"» 
二 一 页 </span>snDbsp</a> 
«a href="#" th:if-"S$(page.pageNum < page.pages)"»«span class-"linkspan" 
id-"three"» h—J1«/span»&nbsp;«/a» 
«a href="#" th:if-"$[page.pageNum !- page.pagesj"»«span class= 
"linkspan" id-"four"»KJi«/span»&nbsp;«/a» 
| 
$| «input  type-"text"  id-"pageNo"  size-4  style-"text-align:right;" 
onkeypress-"onlynumber ();"/» 页 
«button class-"linkspan" id-"five" style-"color:black;text-decoration: 
none;"> 跳 $4 «/button» 
«/div» 
«script type-"text/javascript" th:src-"Q(/js/jquery-3.1.1.min.js)"» 
CacPEIDES 
«script th:inline-"javascript"» 
S(function() ( 
/ /删除 操作 
CE 本 
本 下 
if (confirm(" 确 定 要 删除 吗 ?") ) { 
$("form:eq(0)").attr("action", href).submit(); 


return false; 


)); 
$(".update").click(function () ( 
var href — $S(this).attr(í("href"); 
$(location).attr("href", href); 
)); 
// 分 页 操作 
$(".linkspan").click(function () ( 
var pageNo = [[S$í(page.pageNum]]]; 
var totalPageNum = [[S$(page.pages]]]; 
var re = /^[0-9]-4.?[0-9]*$/; 
if (String($(this).attr("id")) -- String("one")) 
pageNo - 1; 
if (String($(this).attr("id")) -- String("two")) 
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pageNo = pageNo - 1; 


if (String($(this).attr("id")) -- String("three")) 
pageNo = pageNo + 1; 
if (String($(this).attr("id")) -- String("four")) 
¢ pageNo = totalPageNum; 
t if (String($(this).attr("id")) -- String("five")) f 


var num = $.trim($ ("#pageNo") .val () ); 

if (!re.test(num)) ( 
alert ("输入 的 不 是 数字 !"); 
return; 

} 

pageNo = parseInt (num); 

if (pageNo < 1 || pageNo > totalPageNum) ( 
alert ("页 号 超出 范围 ， 有 效 范 围 : [1-" + totalPageNum + "]!"); 


return; 


} 
var act-"?pageNo-"-pageNo; 
Si"torm:egtbl)").attr("action", dcr) .submit(); 
return false; 
)); 
)); 
€«fSscript» 
«/body» 
«/html» 


在 日 录 resources/templates/cource 下 创建 文件 update course.html, (RIB r4] 10-35 所 示 。 
【 例 10-35] 创建 文件 update course.html 的 代码 示例 。 


«!DOCTYPE html» 
«html lang-"en" xmlns:th-"http://www.thymeleaf.org"» 
«head» 
«meta charset-"UTF-8"» 
<title> 修 改 谋 程 类 型 </title> 
«link rel="stylesheet" type="text/css" th:href="@{/css/style.css}" /> 
«script type-"text/javascript" th:src-"Q(/js/jquery-3.1.1.min.js)"» 
«/script» 
</head> 
<body style="padding: 8px; "> 
<h3 class="title"> 新 增 课程 </h3> 
«img id-"textbookPic" 
alt=" 默 认 教 材 封面 " 
width-"300" 
height-"250" 
Cclass-"imgShow" 
style-"float:right" th:src-"8(/course/getPic/(courseNo) (courseNo-$ 
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[(course.courseNo]))" /> 

«br/» 

«form th:action-"8(/course/updatej" method="post" enctype-"multipart/ 
form-data" th:object-"$([course]"» 


«input type="hidden" name-"courseNo" th:value-"*(courseNo]" /> $ 

<div> t 
<span> 课 程 编号 : [[${courseNo}]]</span> 

«/div» 

«div» 


«span» FEAP :«/span» 
«input type="text" name-"courseName" th:value-"*(courseName]" > 
«/div» 
«div» 
«span»334 Hl : </span> 
«input id-"coursetextbookpic" type-"file" name-"coursetextbookpic" 
size-"40" /> 
«/div» 
«div» 
«span» Wk fEURH] : «/span» 
«input type="text" name-"courseHours" th:value-"*(courseHours)]" > 
«/div» 
«div» 
«span» Z :«/span» 
«input type="text" name-"coursePoint" th:value-"*[coursePoint)]" > 
«/div» 
«div» 
<span> 课 程 类 型 :</span> 
«select name-"courseType.typelId" th:value-"*s(courseType.typeId)"» 
«option th:each-"list:$(courseTypeList)" th:value-"$[(list.typeId)" 
th:text-"S$(list.typeName]"» 
«/option» 
«/select» 
«/div» 
«div» 
<span> 课 程 状态 :</span> 
«input type-"radio" name-"courseStatus" th:value-"O" th:checked- 
"S(course.courseStatus eq 'O'j"»5J[H A Xc&nbsp; &nbsp; 
«input type-"radio" name-"courseStatus" th:value-"Z" th:checked- 
"S(course.courseStatus eq 'Zz'}"> 暂 不 开放 &nbsp; &nbsp; 
«input type-"radio" name-"courseStatus" th:value-"C" th:checked- 
"S(course.courseStatus eq 'C'}"> 停 止 授课 gnbsp; &nbsp; 
«/div» 
«div» 
<span> 选 课 条 件 :</span> 
«input id-"a" type-"checkbox" name-"courseReqs" value "a" /»X-UL 
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«input id "D" type-"checkbox" name-"courseReqs" value-"b" /> 
绩 80 分 
«input id "c" type-"checkbox" name-"courseReqs" value-"c" DIR: 
业 学 生 
$ «input id-"d" type="checkbox" name-"courseReqs" value-"d" /> 未 拖欠 
' 学 费 
«/div» 
«div» 
<span>% it Vil] : «/span» 
«textarea name-"courseMemo" rows-"6" cols-"60"»[[S$(course.courseMemo]]] 
«/textarea» 
«/div» 
«div» 
«input type="submit" value=" 修 改 课程 "/> 
«/div» 
«/form» 
</body> 
«script type-"text/javascript" th:src-"Q(/js/jquery-3.1.1.min.js)"» 
«/script» 
«script th:inline-"javascript"» 
S(function() ( 
var courseReqs = [[$(course.courseReqs]]] 
for (var i = 0; i < courseReqs.length; i++) { 
$("£" + courseReqs[i]).attr("checked", true) 
l 
S('4£coursetextbookpic').on('change', function () { 
war filo NS 
var fileObj = file[0]; // 获 取 当 前 元 素 
var dataURL; 
var windowURL - window.URL; 
if (fileObj.files[0]) ( 
dataURL = windowURL.createObjectURL(fileObj.files[0]) 
// 创 建 一 个 新 的 对 象 URL， 该 对 象 URL 可 以 代表 某 一 个 指定 的 File 对 象 或 Blob 对 象 
$('.imgShow').attr('src', dataURL); 
} 
else { 
人 ER ET 
console.log (dataURL) 
$('.imgShow').style.filter = 'progid:DXImageTransform. 
Micsoft.AlphaImageLoader (sizingMethod = scale)' 
$('.imgShow').filters.item('DXImageTransform.Microsoft.AlphaImageLoader 
').src = dataURL; 
) 
$.ajaxFileUpload(( 


HELD TM 
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fileElementId: "uploadImg", 
dataType: "string", 
success: function (data) i 
// 图 片 路 径 
$('.umgShow').attr("src", data); $ 


)); 
pis 
)); 
«/script» 
«/html» 


10.2.12 ”修改 和 创建 配置 文件 


修改 目录 resources 下 配置 文件 application.properties， 代 码 如 例 10-36 所 示 。 
【 例 10-36】 修改 目录 resources 下 配置 文件 application.properties 的 代码 示例 。 


$springboot 乱 公 解决 
server.tomcat.uri-encoding-UTF-8 
spring.http.encoding.charset-UTF-8 
HARA 
spring.devtools.restart.enabled=true 
spring.thymeleaf.mode-HTML5 
spring.thymeleaf.encoding-UTF-8 
spring.thymeleaf.cache-false 
spring.thymeleaf.suffix-.html 

# 加 载 mybatis 配置 文件 


mybatis.mapper-locations-classpath:mybatis/*Mapper.xml 


在 resources 日 录 下 创建 配置 文件 application.yml， 代 人 码 如 例 10-37 所 示 。 
【 例 10-37】 在 resources 目录 下 创建 配置 文件 application.yml 的 代码 示例 。 


spring: 
datasource: 
url: jdbc:mysql: //localhost:3306/xiaozedb 
driver-class-name: com.mysql.jdbc.Driver 
username: root 
password: sa 
druid: 
filters: stat 
maxActive: 20 
initialSize: 1 
maxWait: 30000 
minlIdle: 10 
maxIdle: 15 
timeBetweenEvictionRunsMillis: 60000 
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10.2.13 ”创建 CSS 文件 


在 resources/static/css 下 创建 文件 style.css， 代 码 如 例 10-38 所 示 。 
【 例 10-38] 在 resources/static/css 下 创建 文件 style.css 的 代码 示例 。 
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10.2.14 ”配置 辅助 文件 号 运行 程序 


下 载 jquery-3.1.1.min.js 到 resources/static/js HK F, 在 resources/static/pics 目录 下 配置 
logo.png, sblpng. logoutpng. SpringBootpng. SpringMVC.png. SSH.png. SSM.png. 
JavaEE.png 等 图 片 。 $ 

在 浏览 器 中 输入 localhost:8080， 结 果 如 图 10-1 所 示 。 


习题 10 


请 独立 完成 本 章 的 案例 。 
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